Additional tables for special catalog features[cite: 1]:

  • catalog_pages_bc / catalog_items_bc — Builders Club catalog[cite: 1]
  • catalog_items_limited — tracks limited-edition (RARE) item sales[cite: 1]
  • catalog_club_offers — HC/VIP/BC subscription offers[cite: 1]
  • catalog_clothing — wearable clothing items[cite: 1]
  • catalog_featured_pages — front page featured slots[cite: 1]
  • catalog_target_offers — targeted promotional offers[cite: 1]

Table Schemas

items_base

Defines the base properties of every furniture item. Referenced by catalog_items.item_ids, items.id, and many other tables via foreign key[cite: 1].

Column Type Description
id int(10) unsigned Primary key, matches sprite ID in FurnitureData[cite: 1]
sprite_id int(11) Sprite identifier (usually same as id)[cite: 1]
public_name varchar(56) Display name shown in the client[cite: 1]
item_name varchar(70) Internal classname (matches FurnitureData classname)[cite: 1]
type varchar(3) s = floor item, i = wall item, r = robot/bot, e = effect[cite: 1]
width int(11) Tile width[cite: 1]
length int(11) Tile length[cite: 1]
stack_height double(4,2) Stack height (0.00 = flat, 1.00 = normal stack)[cite: 1]
allow_stack tinyint(1) Can other items be stacked on top[cite: 1]
allow_sit tinyint(1) Can avatars sit on this[cite: 1]
allow_lay tinyint(1) Can avatars lay on this[cite: 1]
allow_walk tinyint(1) Can avatars walk through this[cite: 1]
allow_gift tinyint(1) Can this be wrapped as a gift[cite: 1]
allow_trade tinyint(1) Can players trade this[cite: 1]
allow_recycle tinyint(1) Can this be recycled[cite: 1]
allow_marketplace_sell tinyint(1) Can this be sold on the marketplace[cite: 1]
allow_inventory_stack tinyint(1) Does this stack in inventory[cite: 1]
interaction_type varchar(500) Behavior type (e.g. default, gate, teleport, wired_trigger, dimmer, postit, bed, chair, football_counter, etc.)[cite: 1]
interaction_modes_count int(11) Number of interaction states (e.g. 2 for toggleable items)[cite: 1]
vending_ids varchar(255) Vending machine reward item IDs[cite: 1]
multiheight varchar(50) Multi-height stack data[cite: 1]
customparams varchar(256) Custom parameters (e.g. clothing set IDs)[cite: 1]
effect_id_male int(11) Male avatar effect ID[cite: 1]
effect_id_female int(11) Female avatar effect ID[cite: 1]
clothing_on_walk varchar(255) Clothing effect applied on walk[cite: 1]

catalog_pages

Defines the hierarchical catalog tree structure visible in the Nitro client[cite: 1].

Column Type Description
id int(11) Primary key[cite: 1]
parent_id int(11) Parent page ID (-1 = root page)[cite: 1]
caption_save varchar(25) Internal caption key[cite: 1]
caption varchar(128) Display caption[cite: 1]
page_layout enum Layout type (see source for full enum list)[cite: 1]
icon_color int(11) Catalog icon color (1-255)[cite: 1]
icon_image int(11) Catalog icon image ID[cite: 1]
min_rank int(11) Minimum rank to view[cite: 1]
order_num int(11) Sort order[cite: 1]
visible enum('0','1') Is the page visible[cite: 1]
enabled enum('0','1') Is the page enabled[cite: 1]
club_only enum('0','1') HC/VIP only[cite: 1]
vip_only enum('1','0') VIP only[cite: 1]
page_headline varchar(1024) Headline image/text key[cite: 1]
page_teaser varchar(64) Teaser image key[cite: 1]
page_special varchar(2048) Special layout data[cite: 1]
page_text1 text Primary page text[cite: 1]
page_text2 text Secondary page text[cite: 1]
page_text_details text Detail text[cite: 1]
page_text_teaser text Teaser text[cite: 1]
room_id int(11) Room ID (for room bundle pages)[cite: 1]
includes varchar(128) Semicolon separated page IDs to include[cite: 1]
catalog_mode enum('NORMAL','BUILDER','BOTH') Catalog mode[cite: 1]

catalog_items

Links items_base entries to catalog_pages with pricing and availability[cite: 1].

Column Type Description
id int(11) Primary key[cite: 1]
item_ids varchar(666) Comma-separated items_base IDs[cite: 1]
page_id int(11) FK → catalog_pages.id[cite: 1]
offer_id int(11) Offer ID (-1 = default)[cite: 1]
song_id int(10) unsigned Trax song ID[cite: 1]
order_number int(11) Sort order within the page[cite: 1]
catalog_name varchar(100) Catalog name / offer identifier[cite: 1]
cost_credits int(11) Credit cost[cite: 1]
cost_points int(11) Points/currency cost[cite: 1]
points_type int(11) 0 = duckets, 5 = diamonds, etc.[cite: 1]
amount int(11) Amount received per purchase[cite: 1]
limited_sells int(11) Auto-tracked sales count[cite: 1]
limited_stack int(11) Total limited quantity (0 = unlimited)[cite: 1]
extradata varchar(500) Extra data[cite: 1]
badge varchar(500) Badge code (AtomCMS extension)[cite: 1]
have_offer enum('0','1') Is the offer active[cite: 1]
club_only enum('0','1') HC/VIP only[cite: 1]
rate varchar(255) Rate info (AtomCMS extension)[cite: 1]

Compatibility Matrix

Emulator (Arcturus Morningstar Extended)

  • items_base, catalog_pages, catalog_items: Full native. The emulator reads these directly via DAO[cite: 1].

Nitro-V3 (React Client)

  • Full native via emulator[cite: 1]. The client consumes data via CatalogModeComposer and CatalogOfferComposer protocol messages[cite: 1]. No direct DB access required[cite: 1].

Nitro_Render_V3 (Renderer)

  • items_base is compatible via client[cite: 1]. Renderer consumes FurnitureData.json[cite: 1].

Reference Data

The FullDatabase.sql shipped with the emulator contains the SQL Version 2 New dataset[cite: 1]. It is in the final stages of completion; the structural integrity is verified and stable, with only minor aesthetic asset polish remaining[cite: 1].

See Also

  • /var/www/emulator/Default Database/FullDatabase.sql — Reference Database[cite: 1]
  • /var/www/atomcms/database/schema/mysql-schema.sql — AtomCMS Schema[cite: 1]
  • /var/www/Nitro-V3/src/hooks/furni-editor/useFurniEditor.ts — Client Furni Editor[cite: 1]
S
Description
A complete catalogue for the habbo enviroment
Readme 11 GiB
Languages
HTML 100%