block-crush / báo cáo skin

Tạo skin khối mới:
120 × 120, bảy ảnh, một dòng đăng ký

Kết quả kiểm tra 132 file skin trong game/Content/res và code đọc chúng. Hiện chỉ icon khối được nối vào game. Phần còn lại của cấu hình skin gốc chưa có code dùng.

120×120kích thước mọi icon khối

132 / 132file đúng 120×120 (63 + 68 + 1)

7ảnh mỗi skin (icon1..icon7)

280skin trong TbSkinConfig

1. Icon khối: thành phần duy nhất đang chạy

120 px120 px

Mục	Yêu cầu
Kích thước	120×120 px, vuông
Định dạng	PNG RGBA 8-bit, có kênh alpha
Vùng vẽ	Phủ kín khung. Bbox alpha của cả 69 file mẫu đo được là `(0,0,120,120)`, không có lề trong suốt
Hình dạng	Ô vuông bo góc. Góc ngoài trong suốt (alpha 0)
Màu	Tô sẵn trong ảnh. Game vẽ nguyên bản, không tint
Hiển thị	`kCell = 960 / 8 = 120`, nên ảnh hiện 1:1 trên lưới 8×8

Ảnh thật trong game, hiển thị đúng 120 px trên nền ô caro (viền cam là khung 120×120)

cube_1_woodskin_1301
_differentMaterials

cube_2_woodskin_1302
_differentMaterials

cube_3_woodskin_1303
_differentMaterials

cube_4_woodskin_1304
_differentMaterials

cube_5_woodskin_1305
_differentMaterials

ic_block.png
(mặc định, skin 1000)

base_ic_collection_block
(nền ô gem Travel)

2. Quy ước tên file

Art/feature/skin_different_materials/skins/
  cube_<k>_woodskin_<suffix>_differentMaterials.png

<k> là chữ số thứ blockId-1 trong chuỗi blocks của skin, ví dụ "1234561".
<suffix> là số của skin, ví dụ 1301.
blockId ngoài 1..7 được kẹp về 1..7 (std::clamp trong skinIconPath).
Cho phép dùng chung ảnh. Skin 4013 có blocks = "1111111", tức cả 7 loại khối dùng cùng một ảnh cube_1_....
Nguồn quy ước: SkinMgr.cs:575 (icon không có trong family thì thêm hậu tố _differentMaterials) và BoardView.cpp:224.

3. Đăng ký skin để game dùng được

Thêm dòng vào bảng kPoolIcons[] trong game/Source/screens/board/BoardView.cpp (dòng 205-211):
```
{4020, 1321, "1234561"},   // {id, suffix, blocks}
```
Muốn skin được bốc ngẫu nhiên khi thanh x/25 đầy, thêm id vào kSkinPool trong game/core/src/endless_game.cpp:27.
Skin không có trong kPoolIcons sẽ dùng BlockStyle/Default/ic_block.png.
Chỉ muốn đổi giao diện khối mặc định: ghi đè ic_block.png (120×120), không cần sửa code.

Preview skin trên thanh tiến trình đang gắn cứng skin_shared/skins/cube_3_woodskin_004.png (BoardView.cpp:506). Skin mới sẽ không đổi preview này.

Tôi chưa đọc SkinResourceFamilyMap.cs, nên chưa kiểm tra việc skin ngoài pool có phải đăng ký thêm family hay không.

4. Bàn cờ và nền (ảnh dùng chung, không đổi theo skin)

Ảnh (trong `Art/`)	Kích thước	Ghi chú
LoadCore/Sprite/SkinStyle/qipannew.png	76×1012	Khung bàn cờ, vẽ ở `kFrameSize = 1002`
LoadCore/Sprite/SkinStyle/QiPanxin.png	118×118	Ô nền của lưới
LoadCore/Sprite/SkinStyle/QiPanxingray.png	118×118	Biến thể xám
LoadCore/Sprite/SkinStyle/img_bock_white.png	115×116
LoadCore/Sprite/SkinStyle/img_bock_white_1.png	954×114
LoadCore/Sprite/SkinStyle/img_lx_bg01.png	384×1024	Nền màn Travel
LoadResShared/Sprite/SkinStyle/QiPanbg_1.png	768×2048	Nền
LoadResShared/Sprite/SkinStyle/img_muwen.png	768×2048	Vân gỗ
BlockStyle/Default/base_ic_collection_block.png	120×120	Nền ô gem Travel (id ≥ 100). Gem vẽ đè ở `0.7 × kCell`, tối đa khoảng 84 px

5. Trường cấu hình skin chưa nối vào code port

Mỗi skin trong data_src/config/TbSkinConfig.json có hàng chục trường. Tìm trong game/Source không thấy chỗ nào đọc các trường dưới đây. Kích thước ảnh của nhóm này tôi chưa đo.

Nhóm	Trường	Trạng thái
Màu nền	`BGColor`, `ChessBGColor` (hex 6 ký tự, ví dụ `BD6D2C`)	chưa nối
Màu hiệu ứng	`MatchColor1..8` (`[viền, nền, rgba]`), `BottomBlockEffectColor`, `ComboEdgeColorColor`, `StrokeDiffusionPreMatchColor`	chưa nối
Ảnh phụ	`suipian1..7`, `LightningBlock1..7`, `icon_Big1..6`	chưa nối
Travel	`TravelTragetBaseIcon`, `TravelTragetCollectIcon`, `TopCollectItemBg*`	chưa nối
Hiệu ứng, âm	`Match1..7EffectName`, `ClearSfxKey`, `BgmName`	chưa nối
Khác	`SlotStyleIndex`, `ColorPool`, `TravelDiff`	chưa nối
Icon khối	`icon1..icon7`	đang chạy

Muốn các trường trên đổi được theo skin thì phải nối vào code trước.

6. Danh sách kiểm tra khi giao skin

#	Kiểm tra	Mức
1	Đủ ảnh cho mọi chữ số trong chuỗi `blocks`	bắt buộc
2	Mỗi ảnh đúng 120×120, PNG RGBA 8-bit	bắt buộc
3	Góc trong suốt, thân khối phủ kín khung, không lề thừa	bắt buộc
4	Tên file đúng mẫu mục 2, chữ thường, hậu tố `_differentMaterials`	bắt buộc
5	7 loại khối phân biệt được bằng màu trên nền tối và sáng	nên có
6	Dòng mới trong `kPoolIcons` (và `kSkinPool` nếu cần bốc ngẫu nhiên)	bắt buộc

Số liệu đo từ game/Content/res: skin_shared 63 file, skin_different_materials 68 file, skin_3d 1 file, tất cả 120×120. Chưa đo kích thước ảnh của các trường mục 5. Báo cáo không thay đổi gì trong repo ngoài thư mục xem thử này.