Files
Arcturus-Morningstar-Extended/docs/emulator_settings_reference.md
T

44 KiB

Emulator Settings Reference

Scope

This document inventories the non-wired keys currently stored in emulator_settings based on Default Database/FullDB.sql. Wired-specific keys are documented separately in docs/wired_tools_reference.md.

Each entry below mirrors the comment written by Database Updates/003_add_comment_column_to_emulator_settings.sql, so the documentation and in-database comments stay aligned.

Table schema

CREATE TABLE `emulator_settings` (
  `key` varchar(100) NOT NULL,
  `value` varchar(512) NOT NULL,
  `comment` text NOT NULL,
  PRIMARY KEY (`key`)
);

Inventory summary

  • Total non-wired keys documented here: 329
  • Source of defaults: Default Database/FullDB.sql
  • Value type is inferred from the default string stored in SQL.

Group index

  • allowed (1)
  • apollyon (1)
  • basejump (2)
  • bots (1)
  • bubblealerts (6)
  • bundle (2)
  • callback (3)
  • camera (11)
  • catalog (5)
  • commands (3)
  • console (1)
  • custom (1)
  • db (4)
  • debug (7)
  • discount (5)
  • easter_eggs (1)
  • enc (4)
  • essentials (2)
  • flood (1)
  • ftp (4)
  • furniture (1)
  • gamecenter (16)
  • gamedata (1)
  • guardians (5)
  • hotel (169)
  • hotelview (5)
  • imager (6)
  • images (2)
  • info (1)
  • invisible (1)
  • io (3)
  • logging (6)
  • marketplace (1)
  • monsterplant (2)
  • moodlight (1)
  • navigator (1)
  • networking (1)
  • notify (1)
  • path (1)
  • pathfinder (4)
  • pirate_parrot (2)
  • postit (1)
  • pyramids (1)
  • retro (1)
  • room (4)
  • rosie (2)
  • runtime (1)
  • save (2)
  • scripter (1)
  • seasonal (7)
  • subscriptions (12)
  • team (1)
  • youtube (1)

allowed

Validation rules for usernames and account-facing inputs.

Key Default value Type Purpose
allowed.username.characters abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890-=!?@:,. list Characters allowed when users choose or change a username.

apollyon

Custom project-specific behaviour switches.

Key Default value Type Purpose
apollyon.cooldown.amount 250 integer Cooldown in milliseconds used by the Apollyon-specific behaviour or command flow.

basejump

BaseJump or FastFood launcher URLs.

Key Default value Type Purpose
basejump.assets.url http://localhost/gamecenter/gamecenter_basejump/BasicAssets.swf url Asset URL used by the BaseJump or FastFood game client.
basejump.url http://localhost/game/BaseJump.swf url SWF URL used to launch the BaseJump or FastFood game client.

bots

Miscellaneous visitor-bot display settings.

Key Default value Type Purpose
bots.visitor.dateformat yyyy-mm-dd HH:mm string Date format used by visitor bots when they print timestamps.

bubblealerts

Bubble notification behaviour and assets.

Key Default value Type Purpose
bubblealerts.enabled 1 boolean Master switch for bubble alert notifications.
bubblealerts.notif_friendonline.enabled 1 boolean Enable bubble alerts when friends come online.
bubblealerts.notif_friendonline.image ${image.library.url}notifications/figure?p=%figure% template Image template used when showing friend-online bubble alerts.
bubblealerts.notif_friendonline.useimage 1 boolean Use the configured figure image inside friend-online bubble alerts.
bubblealerts.notif_marketplace.enabled 1 boolean Show bubble alerts for marketplace notifications.
bubblealerts.notif_purchase.limited 0 boolean Show bubble alerts for limited-item purchases.

bundle

Bundle-specific toggles for pets and bots.

Key Default value Type Purpose
bundle.bots.enabled 1 boolean Allow bots to be included in room bundles or package rewards.
bundle.pets.enabled 1 boolean Allow pets to be included in room bundles or package rewards.

callback

HTTP callback integrations for external services.

Key Default value Type Purpose
callback.get.version 1 boolean Enable the GET callback used to report version to external services.
callback.post.errors 1 boolean Enable the POST callback used to report errors to external services.
callback.post.statistics 1 boolean Enable the POST callback used to report statistics to external services.

camera

Camera costs, storage and publish settings.

Key Default value Type Purpose
camera.enabled 1 boolean Enable the in-room camera feature.
camera.extradata {\"t\":%timestamp%, \"u\":\"%id%\", \"s\":%room_id%, \"w\":\"%url%\"} template Extradata template written into camera photo items when they are created.
camera.item_id 45970 integer Base item ID used by the generated camera photo furniture.
camera.price.credits 2 integer Credit price charged when taking a camera photo.
camera.price.points 0 boolean Amount of activity points charged when taking a camera photo.
camera.price.points.publish 10 integer Amount of activity points charged when publishing a camera photo.
camera.price.points.publish.type 0 boolean Activity point type used for the camera publish cost.
camera.price.points.type 0 boolean Activity point type used for the camera capture cost.
camera.publish.delay 180 integer Delay in seconds before a published camera photo becomes available.
camera.url http://localhost/usercontent/camera/ url Base URL where camera images are published.
camera.use.https 1 boolean Force HTTPS when generating camera image URLs.

catalog

Catalog behaviour that is not wired-specific.

Key Default value Type Purpose
catalog.guild.hc_required 1 boolean Require HC or VIP status before users can create a guild.
catalog.guild.price 10 integer Credit cost required to create a guild.
catalog.ltd.page.soldout 761 integer Layout or image ID used when a limited page is sold out.
catalog.ltd.random 1 boolean Randomize the order or selection of limited catalog items.
catalog.page.vipgifts 0 boolean Catalog page ID used for VIP gift redemption.

commands

Command-specific restrictions and compatibility flags.

Key Default value Type Purpose
commands.cmd_chatcolor.banned_numbers 23;33;34 list Semicolon-separated list of chat color IDs blocked for the chatcolor command.
commands.cmd_staffonline.min_rank 2 integer Minimum permission rank required to use the staffonline command.
commands.plugins.oldstyle 0 boolean Use the legacy command plugin loading style.

console

Console behaviour.

Key Default value Type Purpose
console.mode 1 boolean Controls the emulator console mode or console output style.

custom

Fork-specific custom behaviour switches.

Key Default value Type Purpose
custom.stacking.enabled 0 boolean Enable custom item stacking behaviour outside the default stacking rules.

db

Database pooling and batching controls.

Key Default value Type Purpose
db.max.partition.size 2 integer Maximum batch or partition size used by partitioned database operations.
db.min.partition.size 1 boolean Minimum batch or partition size used by partitioned database operations.
db.pool.maxsize 12 integer Maximum size of the database connection pool.
db.pool.minsize 8 integer Minimum number of open connections kept in the database pool.

debug

Verbose debug output toggles.

Key Default value Type Purpose
debug.mode 1 boolean Enable general emulator debug mode.
debug.show.errors 1 boolean Show internal debug error messages.
debug.show.headers 0 boolean Show packet headers in debug logs.
debug.show.packets 0 boolean Print packet-level debug output.
debug.show.packets.undefined 0 boolean Print debug output for undefined incoming or outgoing packets.
debug.show.sql.exception 1 boolean Log SQL exceptions to the console.
debug.show.users 1 boolean Show user-related debug messages.

discount

Discount batch rules for catalog purchases.

Key Default value Type Purpose
discount.additional.thresholds 40;99 list Semicolon-separated discount thresholds used for extra batch bonuses.
discount.batch.free.items 1 boolean Number of free items granted inside one discount batch.
discount.batch.size 6 integer Number of items required for one discount batch.
discount.bonus.min.discounts 1 boolean Minimum number of discount batches required before the bonus logic applies.
discount.max.allowed.items 100 integer Maximum number of catalog items that can participate in one discount batch.

easter_eggs

Optional easter egg features.

Key Default value Type Purpose
easter_eggs.enabled 1 boolean Enable or disable the feature controlled by easter_eggs.enabled.

enc

Encryption and RSA settings.

Key Default value Type Purpose
enc.d `` string RSA private exponent used by the encryption layer.
enc.e `` string RSA public exponent used by the encryption layer.
enc.enabled 1 boolean Enable RSA encryption support for the socket handshake.
enc.n `` string RSA modulus used by the encryption layer.

essentials

Essentials plugin or command values.

Key Default value Type Purpose
essentials.cmd_kill.effect.killer 164;182 list Semicolon-separated effect IDs used by the kill command for the killer.
essentials.cmd_kill.effect.victim 93;89 list Semicolon-separated effect IDs used by the kill command for the victim.

flood

Flood-control compatibility switches.

Key Default value Type Purpose
flood.with.rights 0 boolean Allow users with room rights to bypass the normal flood protection.

ftp

FTP integration settings for generated assets.

Key Default value Type Purpose
ftp.enabled 0 boolean Enable FTP uploads for generated assets.
ftp.host example.com string FTP host used for asset uploads.
ftp.password password123 string FTP password used for asset uploads.
ftp.user root string FTP username used for asset uploads.

furniture

General furniture interaction behaviour.

Key Default value Type Purpose
furniture.talking.range 2 integer Maximum tile distance at which talking furniture can react to nearby speech.

gamecenter

Gamecenter launchers and theme settings.

Key Default value Type Purpose
gamecenter.fastfood.apiKey `` string API key used by the FastFood or BaseJump integration.
gamecenter.fastfood.assets http://localhost/swf/c_images/gamecenter_basejump/ url Asset base URL used by the FastFood or BaseJump game client.
gamecenter.fastfood.background.color 68bbd2 string Background color used by the FastFood launcher UI.
gamecenter.fastfood.enabled true boolean Enable the FastFood or BaseJump gamecenter integration.
gamecenter.fastfood.text.color ffffff string Text color used by the FastFood launcher UI.
gamecenter.fastfood.theme default string Theme name used by the FastFood launcher.
gamecenter.snowwar.artic.bg http://localhost/swf/c_images/gamecenter_snowwar/snst_bg_1_a_big.png url Background image used for the SnowWar Arctic map.
gamecenter.snowwar.assets http://localhost/swf/c_images/gamecenter_snowwar/ url Asset base URL used by the SnowWar game client.
gamecenter.snowwar.dragoncave.bg http://localhost/swf/c_images/gamecenter_snowwar/snst_bg_2_big.png url Background image used for the SnowWar Dragon Cave map.
gamecenter.snowwar.enabled true boolean Enable the SnowWar gamecenter integration.
gamecenter.snowwar.fightnight.bg http://localhost/swf/c_images/gamecenter_snowwar/snst_bg_3_noscale.png url Background image used for the SnowWar Fight Night map.
gamecenter.snowwar.game.background.color 93d4f3 string Background color used by the SnowWar launcher UI.
gamecenter.snowwar.game.start.time 15 integer Countdown in seconds before a SnowWar round starts.
gamecenter.snowwar.game.text.color 000000 integer Text color used by the SnowWar launcher UI.
gamecenter.snowwar.players.min 2 integer Minimum number of players required to start SnowWar.
gamecenter.snowwar.room.id 0 boolean Room ID used as the SnowWar lobby or host room.

gamedata

Remote gamedata sources.

Key Default value Type Purpose
gamedata.figuredata.url https://habbo.com/gamedata/figuredata/0 url Remote figuredata URL used when the hotel loads avatar figure definitions.

guardians

Guardians and report-review settings.

Key Default value Type Purpose
guardians.accept.timer 90 integer Time in seconds that guardians have to accept a case.
guardians.maximum.guardians.total 10 integer Maximum number of guardians that can be assigned to one case.
guardians.maximum.resends 2 integer Maximum number of times an unanswered guardian case can be resent.
guardians.minimum.votes 5 integer Minimum number of guardian votes required to resolve a case.
guardians.reporting.cooldown 900 integer Cooldown in seconds before the same user can open a new guardian report.

hotel

Core hotel gameplay, economy, room, catalog and moderation settings.

Key Default value Type Purpose
hotel.alert.oldstyle 0 boolean Use the legacy generic alert window style.
hotel.allow.ignore.staffs 1 boolean Allow users to ignore staff accounts.
hotel.auto.credits.amount 100 integer Amount of credits granted on each automatic payout.
hotel.auto.credits.enabled 1 boolean Enable automatic credits payouts.
hotel.auto.credits.hc_modifier 1 boolean Multiplier applied to automatic credits payouts for HC users.
hotel.auto.credits.ignore.hotelview 1 boolean Skip users staying in hotel view when giving automatic credits payouts.
hotel.auto.credits.ignore.idled 0 boolean Skip idle users when giving automatic credits payouts.
hotel.auto.credits.interval 600 integer Interval in seconds between automatic credits payouts.
hotel.auto.gotwpoints.enabled 0 boolean Enable automatic gotwpoints payouts.
hotel.auto.gotwpoints.hc_modifier 1 boolean Multiplier applied to automatic gotwpoints payouts for HC users.
hotel.auto.gotwpoints.ignore.hotelview 1 boolean Skip users staying in hotel view when giving automatic gotwpoints payouts.
hotel.auto.gotwpoints.ignore.idled 1 boolean Skip idle users when giving automatic gotwpoints payouts.
hotel.auto.gotwpoints.interval 600 integer Interval in seconds between automatic gotwpoints payouts.
hotel.auto.gotwpoints.name shell string Internal currency name used by the automatic gotwpoints payout.
hotel.auto.gotwpoints.type 4 integer Currency type ID used by the automatic gotwpoints payout.
hotel.auto.pixels.amount 100 integer Amount of pixels granted on each automatic payout.
hotel.auto.pixels.enabled 1 boolean Enable automatic pixels payouts.
hotel.auto.pixels.hc_modifier 1 boolean Multiplier applied to automatic pixels payouts for HC users.
hotel.auto.pixels.ignore.hotelview 1 boolean Skip users staying in hotel view when giving automatic pixels payouts.
hotel.auto.pixels.ignore.idled 1 boolean Skip idle users when giving automatic pixels payouts.
hotel.auto.pixels.interval 600 integer Interval in seconds between automatic pixels payouts.
hotel.auto.points.amount 5 integer Amount of points granted on each automatic payout.
hotel.auto.points.enabled 1 boolean Enable automatic points payouts.
hotel.auto.points.hc_modifier 1 boolean Multiplier applied to automatic points payouts for HC users.
hotel.auto.points.ignore.hotelview 0 boolean Skip users staying in hotel view when giving automatic points payouts.
hotel.auto.points.ignore.idled 0 boolean Skip idle users when giving automatic points payouts.
hotel.auto.points.interval 600 integer Interval in seconds between automatic points payouts.
hotel.banzai.points.tile.fill 0 boolean Configuration value used by hotel.banzai.points.tile.fill.
hotel.banzai.points.tile.lock 1 boolean Configuration value used by hotel.banzai.points.tile.lock.
hotel.banzai.points.tile.steal 0 boolean Configuration value used by hotel.banzai.points.tile.steal.
hotel.bot.butler.commanddistance 5 integer Maximum tile distance from which a butler bot accepts commands.
hotel.bot.butler.servedistance 5 integer Maximum tile distance from which a butler bot can serve requests.
hotel.bot.chat.minimum.interval 5 integer Minimum number of seconds between bot chat lines.
hotel.bot.max.chatdelay 604800 integer Maximum bot chat delay allowed when configuring scripted speech.
hotel.bot.max.chatlength 120 integer Maximum number of characters allowed in bot chat lines.
hotel.bot.max.namelength 15 integer Maximum number of characters allowed in bot names.
hotel.bots.max.inventory 25 integer Maximum number of bots allowed in one inventory.
hotel.bots.max.room 10 integer Maximum number of bots allowed in one room.
hotel.calendar.default test string Default calendar campaign name or identifier.
hotel.calendar.enabled 0 boolean Enable the hotel calendar feature.
hotel.calendar.pixels.hc_modifier 2.0 number Multiplier applied to calendar pixel rewards for HC users.
hotel.calendar.starttimestamp 1593561600 integer Unix timestamp used as the calendar start date.
hotel.catalog.discounts.amount 6 integer Number of discount slots or discount batches shown by the catalog.
hotel.catalog.items.display.ordernum 1 boolean Respect catalog item order numbers when rendering pages.
hotel.catalog.ltd.limit.enabled 1 boolean Enable daily purchase limits for limited catalog items.
hotel.catalog.purchase.cooldown 1 boolean Cooldown in seconds between catalog purchases.
hotel.catalog.recycler.enabled 1 boolean Enable the catalog recycler feature.
hotel.chat.max.length 100 integer Maximum number of characters allowed in one public chat message.
hotel.daily.respect 3 integer Daily amount of respect points available for users.
hotel.daily.respect.pets 3 integer Daily amount of pet respect points available for users.
hotel.ecotron.enabled 1 boolean Enable or disable the feature controlled by hotel.ecotron.enabled.
hotel.ecotron.rarity.chance.1 1 boolean Configuration value used by hotel.ecotron.rarity.chance.1.
hotel.ecotron.rarity.chance.2 4 integer Configuration value used by hotel.ecotron.rarity.chance.2.
hotel.ecotron.rarity.chance.3 40 integer Configuration value used by hotel.ecotron.rarity.chance.3.
hotel.ecotron.rarity.chance.4 200 integer Configuration value used by hotel.ecotron.rarity.chance.4.
hotel.ecotron.rarity.chance.5 2000 integer Configuration value used by hotel.ecotron.rarity.chance.5.
hotel.flood.mute.time 30 integer Mute duration in seconds applied by the hotel flood protection.
hotel.floorplan.max.totalarea 4096 integer Maximum total floorplan area allowed for custom rooms.
hotel.floorplan.max.widthlength 64 integer Maximum floorplan width or length allowed for custom rooms.
hotel.freeze.onfreeze.loose.explosionboost 3 integer Number of explosion boosts lost when a player gets frozen.
hotel.freeze.onfreeze.loose.snowballs 5 integer Number of snowballs lost when a player gets frozen.
hotel.freeze.onfreeze.time.frozen 5 integer Time in seconds a player remains frozen.
hotel.freeze.points.block 1 boolean Score awarded for blocking tiles in Freeze.
hotel.freeze.points.effect 3 integer Score awarded for using Freeze effects or power-up actions.
hotel.freeze.points.freeze 10 integer Score awarded for freezing another player in Freeze.
hotel.freeze.powerup.chance 33 integer Chance for Freeze power-ups to spawn.
hotel.freeze.powerup.max.lives 3 integer Maximum number of extra lives granted by a Freeze power-up.
hotel.freeze.powerup.max.snowballs 5 integer Maximum number of extra snowballs granted by a Freeze power-up.
hotel.freeze.powerup.protection.stack 1 boolean Allow Freeze protection power-ups to stack.
hotel.freeze.powerup.protection.time 10 integer Protection time in seconds after receiving a Freeze protection power-up.
hotel.friendcategory 0 boolean Default friend category ID assigned to new friends.
hotel.furni.gym.achievement.olympics_c16_crosstrainer CrossTrainer string Configuration value used by hotel.furni.gym.achievement.olympics_c16_crosstrainer.
hotel.furni.gym.achievement.olympics_c16_trampoline Trampolinist string Configuration value used by hotel.furni.gym.achievement.olympics_c16_trampoline.
hotel.furni.gym.achievement.olympics_c16_treadmill Jogger string Configuration value used by hotel.furni.gym.achievement.olympics_c16_treadmill.
hotel.furni.gym.forcerot.olympics_c16_crosstrainer 1 boolean Configuration value used by hotel.furni.gym.forcerot.olympics_c16_crosstrainer.
hotel.furni.gym.forcerot.olympics_c16_trampoline 0 boolean Configuration value used by hotel.furni.gym.forcerot.olympics_c16_trampoline.
hotel.furni.gym.forcerot.olympics_c16_treadmill 1 boolean Configuration value used by hotel.furni.gym.forcerot.olympics_c16_treadmill.
hotel.gifts.box_types 0,1,2,3,4,5,6,8 list Comma-separated list of gift box type IDs allowed in the catalog.
hotel.gifts.length.max 300 integer Maximum message length allowed on gift notes.
hotel.gifts.ribbon_types 0,1,2,3,4,5,6,7,8,9,10 list Comma-separated list of ribbon type IDs allowed in the catalog.
hotel.gifts.special.price 10 integer Credit price used by special gift boxes.
hotel.home.room 0 boolean Room ID used as the default home room for new users.
hotel.inventory.max.items 7500 integer Maximum number of items allowed in one inventory.
hotel.item.trap.hween14_rare2 3000 integer Configuration value used by hotel.item.trap.hween14_rare2.
hotel.item.trap.hween_c17_handstrap 3000 integer Configuration value used by hotel.item.trap.hween_c17_handstrap.
hotel.item.trap.hween_c17_spiketrap 3000 integer Configuration value used by hotel.item.trap.hween_c17_spiketrap.
hotel.item.trap.pirate_sandtrap 3000 integer Configuration value used by hotel.item.trap.pirate_sandtrap.
hotel.jukebox.limit.large 20 integer Track limit used by large jukebox furniture.
hotel.jukebox.limit.normal 10 integer Track limit used by normal jukebox furniture.
hotel.log.chat 1 boolean Enable logging for chat.
hotel.log.chat.private 1 boolean Enable logging for chat private.
hotel.log.room.enter 1 boolean Enable logging for room enter.
hotel.log.trades 1 boolean Enable logging for trades.
hotel.marketplace.currency 0 boolean Currency type used for marketplace prices and taxes.
hotel.marketplace.enabled 1 boolean Enable or disable the feature controlled by hotel.marketplace.enabled.
hotel.max.bots.room 10 integer Maximum number of bots allowed in one room.
hotel.max.duckets 9000000 integer Maximum amount of duckets a user can hold.
hotel.messenger.offline.messaging.enabled 1 boolean Enable or disable the feature controlled by hotel.messenger.offline.messaging.enabled.
hotel.messenger.search.maxresults 50 integer Maximum number of results returned by messenger user searches.
hotel.name Habbo Hotel string Public hotel name shown across the client and outgoing messages.
hotel.navigator.camera 1 boolean Enable navigator room previews or camera mode.
hotel.navigator.owner HabboHotel string Default owner name displayed by the navigator.
hotel.navigator.popular.amount 35 integer Number of rooms shown in the popular rooms list.
hotel.navigator.popular.category.maxresults 10 integer Maximum number of rooms shown per popular category.
hotel.navigator.popular.listtype 1 boolean List type used for the popular rooms tab.
hotel.navigator.populartab.publics 0 boolean Include public rooms inside the popular rooms tab.
hotel.navigator.search.maxresults 35 integer Maximum number of results returned by navigator searches.
hotel.navigator.sort.ordernum 1 boolean Respect order numbers when sorting navigator results.
hotel.navigator.staffpicks.categoryid 1 boolean Category ID used for the staff picks tab.
hotel.nux.gifts.enabled 0 boolean Enable the NUX gift flow for new users.
hotel.pets.max.inventory 25 integer Maximum number of pets allowed in one inventory.
hotel.pets.max.room 10 integer Maximum number of pets allowed in one room.
hotel.pets.name.length.max 15 integer Maximum pet name length.
hotel.pets.name.length.min 3 integer Minimum pet name length.
hotel.player.name Habbo string Generic player label used by text templates and client messages.
hotel.purchase.ltd.limit.daily.item 3 integer Maximum number of the same limited item a user can buy per day.
hotel.purchase.ltd.limit.daily.total 10 integer Maximum number of limited items a user can buy per day across all limited sales.
hotel.refill.daily 86400 integer Cooldown in seconds before daily counters such as respect are refilled.
hotel.rollers.speed.maximum 100 integer Maximum roller delay or speed value accepted by roller furniture.
hotel.room.enter.logs 1 boolean Enable room-entry logs.
hotel.room.floorplan.check.enabled 1 boolean Validate custom floorplans before rooms are saved.
hotel.room.furni.max 2500 integer Maximum amount of furniture allowed in one room.
hotel.room.nooblobby 3 integer Room ID used as the newbie lobby.
hotel.room.public.doortile.kick 0 boolean Kick users who stand on public room door tiles.
hotel.room.rollers.norules 0 boolean Allow rollers to ignore normal placement rules.
hotel.room.rollers.roll_avatars.max 1 boolean Maximum number of avatars that rollers can move at once.
hotel.room.stickies.max 200 integer Maximum number of sticky notes allowed in one room.
hotel.room.stickypole.prefix %timestamp%, %username%:\\r template Prefix template written by sticky pole furniture.
hotel.room.tags.staff staff;official;habbo list Semicolon-separated staff room tags.
hotel.rooms.auto.idle 1 boolean Allow empty rooms to switch into the idle state automatically.
hotel.rooms.deco_hosting 1 boolean Enable decoration-hosting features for rooms.
hotel.rooms.handitem.time 100 integer Time in seconds before temporary hand items are cleared.
hotel.rooms.max.favorite 30 integer Maximum number of favorite rooms allowed per user.
hotel.roomuser.idle.cycles 300 integer Idle cycle count before a room user is marked idle.
hotel.roomuser.idle.cycles.kick 900 integer Idle cycle count before a room user is kicked for idling.
hotel.roomuser.idle.not_dancing.ignore.wired_idle 0 boolean Ignore the wired idle status when checking the room idle rule.
hotel.sanctions.enabled 1 boolean Enable the sanctions system.
hotel.shop.discount.modifier 6 integer Modifier used by the shop discount calculation.
hotel.talenttrack.enabled 1 boolean Enable the talent track feature.
hotel.targetoffer.id 1 boolean Offer ID requested when the client asks for a targeted offer.
hotel.teleport.locked.allowed 1 boolean Allow users to use teleports inside locked rooms when they otherwise qualify.
hotel.trading.enabled 1 boolean Enable room trading.
hotel.trading.requires.perk 0 boolean Require the trading perk before users may trade.
hotel.trophies.length.max 300 integer Maximum value used by hotel.trophies.length.max.
hotel.users.clothingvalidation.onchangelooks 0 boolean Run clothing validation when the related action occurs: onchangelooks.
hotel.users.clothingvalidation.onfballgate 0 boolean Run clothing validation when the related action occurs: onfballgate.
hotel.users.clothingvalidation.onhcexpired 0 boolean Run clothing validation when the related action occurs: onhcexpired.
hotel.users.clothingvalidation.onlogin 0 boolean Run clothing validation when the related action occurs: onlogin.
hotel.users.clothingvalidation.onmannequin 0 boolean Run clothing validation when the related action occurs: onmannequin.
hotel.users.clothingvalidation.onmimic 0 boolean Run clothing validation when the related action occurs: onmimic.
hotel.users.max.friends 300 integer Maximum number of friends allowed for normal users.
hotel.users.max.friends.hc 1100 integer Maximum number of friends allowed for HC users.
hotel.users.max.rooms 50 integer Maximum number of rooms allowed for normal users.
hotel.users.max.rooms.hc 75 integer Maximum number of rooms allowed for HC users.
hotel.view.ltdcountdown.enabled 1 boolean Enable the limited-countdown hotel-view widget.
hotel.view.ltdcountdown.itemid 10388 integer Item ID shown by the limited-countdown widget.
hotel.view.ltdcountdown.itemname trophy_netsafety_0 string Item name shown by the limited-countdown widget.
hotel.view.ltdcountdown.pageid 13 integer Catalog page ID linked by the limited-countdown widget.
hotel.view.ltdcountdown.timestamp 1519496132 integer Unix timestamp used by the limited-countdown widget.
hotel.welcome.alert.delay 10000 integer Delay in milliseconds before the welcome alert is shown.
hotel.welcome.alert.enabled 0 boolean Enable the welcome alert shown after login.
hotel.welcome.alert.message Welcome to Habbo Hotel %user%! template Message template used by the welcome alert.
hotel.welcome.alert.oldstyle 0 boolean Use the legacy welcome alert window style.
hotel.wordfilter.automute 1 boolean Mute duration in minutes applied when word-filter automute is triggered.
hotel.wordfilter.enabled 1 boolean Enable the word filter system.
hotel.wordfilter.messenger 1 boolean Apply the word filter to messenger messages.
hotel.wordfilter.normalise 1 boolean Normalise text before checking it against the word filter.
hotel.wordfilter.replacement bobba string Replacement word used when text is censored.
hotel.wordfilter.rooms 1 boolean Apply the word filter to room chat.

hotelview

Hotel-view widgets and promotional data.

Key Default value Type Purpose
hotelview.halloffame.query SELECT users.look, users.username, users.id, users_settings.hof_points FROM users_settings INNER JOIN users ON users_settings.user_id = users.id WHERE hof_points > 0 ORDER BY hof_points DESC, users.id ASC LIMIT 10 sql SQL query used to populate the hotel-view hall of fame panel.
hotelview.promotional.points 100 integer Amount of activity points awarded by the hotel-view promotion.
hotelview.promotional.points.type 5 integer Activity point type used by the hotel-view promotional reward.
hotelview.promotional.reward.id 11043 integer Base item ID used by the hotel-view promotional reward.
hotelview.promotional.reward.name bonusbag20_2 string Public item name used by the hotel-view promotional reward.

imager

Internal image generator paths and URLs.

Key Default value Type Purpose
imager.internal.enabled 1 boolean Generate images locally instead of relying on an external imager service.
imager.location.badgeparts /var/www/testhotel/Cosmic/public/usercontent/badgeparts string Filesystem path where badge part assets are stored.
imager.location.output.badges /var/www/testhotel/Cosmic/public/usercontent/badgeparts/generated/ string Filesystem output path for generated badges.
imager.location.output.camera /var/www/testhotel/Cosmic/public/usercontent/camera/ string Filesystem output path for saved camera photos.
imager.location.output.thumbnail /var/www/testhotel/Cosmic/public/usercontent/camera/thumbnail/ string Filesystem output path for generated camera thumbnails.
imager.url.youtube imager.php?url=http://img.youtube.com/vi/%video%/default.jpg template Template URL used to fetch YouTube thumbnails.

images

Static client image path helpers.

Key Default value Type Purpose
images.gamecenter.basejump c_images/gamecenter_basejump/ string Client asset path used for the basejump gamecenter images.
images.gamecenter.snowwar c_images/gamecenter_snowwar/ string Client asset path used for the snowwar gamecenter images.

info

Global information panel toggle.

Key Default value Type Purpose
info.shown 1 boolean Show the hotel information panel or startup information message.

invisible

Invisible-mode behaviour.

Key Default value Type Purpose
invisible.prevent.chat 0 boolean Prevent invisible users from speaking in rooms.

io

Socket and Netty threading settings.

Key Default value Type Purpose
io.bossgroup.threads 1 boolean Number of Netty boss-group threads used by the socket server.
io.client.multithreaded.handler 1 boolean Handle incoming client packets with a multi-threaded pipeline.
io.workergroup.threads 5 integer Number of Netty worker-group threads used by the socket server.

logging

Structured emulator logging toggles.

Key Default value Type Purpose
logging.debug 0 boolean Enable extra debug logging in the emulator logger.
logging.errors.packets 0 boolean Log packet parsing errors.
logging.errors.runtime 1 boolean Log runtime exceptions.
logging.errors.sql 1 boolean Log SQL errors.
logging.packets 0 boolean Log packet traffic in the standard logger.
logging.packets.undefined 0 boolean Log undefined packets in the standard logger.

marketplace

Marketplace compatibility flag.

Key Default value Type Purpose
marketplace.enabled 1 boolean Global switch for the marketplace subsystem.

monsterplant

Monster plant seed item mapping.

Key Default value Type Purpose
monsterplant.seed.item_id 4582 integer Configuration value used by monsterplant.seed.item_id.
monsterplant.seed_rare.item_id 4604 integer Configuration value used by monsterplant.seed_rare.item_id.

moodlight

Moodlight validation switches.

Key Default value Type Purpose
moodlight.color_check.enabled 1 boolean Validate moodlight color values before applying them.

navigator

Navigator static definitions.

Key Default value Type Purpose
navigator.eventcategories 1,Hottest Events,false;2,Parties & Music,true;3,Role Play,true;4,Help Desk,true;5,Trading,true;6,Games,true;7,Debates & Discussions,true;8,Grand Openings,true;9,Friending,true;10,Jobs,true;11,Group Events,true list Semicolon-separated navigator event category definitions shown in the events tab.

networking

Low-level networking compatibility switches.

Key Default value Type Purpose
networking.tcp.proxy 0 boolean Enable TCP proxy-aware networking behaviour.

notify

Server-side notification automation.

Key Default value Type Purpose
notify.staff.chat.auto.report 1 boolean Automatically notify staff when a chat report is created.

path

Asset path helpers.

Key Default value Type Purpose
path.furniture.icons ${image.library.url}/icons/ template Base path used by the client to load furniture icon assets.

pathfinder

Pathfinder safety and performance settings.

Key Default value Type Purpose
pathfinder.execution_time.milli 25 integer Maximum pathfinder execution time in milliseconds before aborting.
pathfinder.max_execution_time.enabled 1 boolean Enforce the pathfinder execution time limit.
pathfinder.step.allow.falling 1 boolean Allow the pathfinder to walk down falling steps.
pathfinder.step.maximum.height 1.1 number Maximum height difference the pathfinder may step onto.

pirate_parrot

Pirate parrot text and bubble behaviour.

Key Default value Type Purpose
pirate_parrot.message.bubble 28 integer Chat bubble style ID used by the pirate parrot.
pirate_parrot.message.count 6 integer Number of predefined messages available to the pirate parrot.

postit

Post-it constraints.

Key Default value Type Purpose
postit.charlimit 366 integer Maximum number of characters allowed on post-it notes.

pyramids

Pyramids minigame timing.

Key Default value Type Purpose
pyramids.max.delay 18 integer Maximum delay allowed in the Pyramids minigame or puzzle timing.

retro

Retro compatibility switches.

Key Default value Type Purpose
retro.style.homeroom 1 boolean Use retro-style home room behaviour in the navigator or onboarding flow.

room

Generic room chat and promotion behaviour.

Key Default value Type Purpose
room.chat.delay 0 boolean Extra room chat delay applied before users can speak again.
room.chat.mutearea.allow_whisper 1 boolean Allow whispering while a user stands inside a mute area.
room.chat.prefix.format [<font color=\"%color%\">%prefix%</font>] string HTML or text format used for room chat prefixes.
room.promotion.badge RADZZ string Badge code displayed on promoted rooms.

rosie

Rosie-related client notifications and purchase currency.

Key Default value Type Purpose
rosie.bubble.image.url ${image.library.url}notifications/generic.png template Image used by Rosie bubble notifications.
rosie.buyroom.currency.type 5 integer Currency type used by Rosie when buying a room or room package.

runtime

Executor and thread sizing.

Key Default value Type Purpose
runtime.threads 8 integer Configuration value used by runtime.threads.

save

Chat persistence toggles.

Key Default value Type Purpose
save.private.chats 1 boolean Configuration value used by save.private.chats.
save.room.chats 1 boolean Configuration value used by save.room.chats.

scripter

Scripter or modtool integration.

Key Default value Type Purpose
scripter.modtool.tickets 1 boolean Expose moderation tickets to the scripter or automation tooling.

seasonal

Seasonal currency mapping.

Key Default value Type Purpose
seasonal.currency.diamond 5 integer Currency type ID used for diamonds.
seasonal.currency.ducket 0 boolean Currency type ID used for duckets.
seasonal.currency.names ducket;pixel;shell;diamond list Semicolon-separated display names for seasonal currency types.
seasonal.currency.pixel 0 boolean Currency type ID used for pixels.
seasonal.currency.shell 4 integer Currency type ID used for shells.
seasonal.primary.type 5 integer Primary seasonal currency type ID.
seasonal.types 0;1;2;3;4;5;101;102;103;104;105 list Semicolon-separated list of currency type IDs treated as seasonal currencies.

subscriptions

HC scheduler, payday and discount configuration.

Key Default value Type Purpose
subscriptions.hc.achievement VipHC string Achievement code granted for the HC subscription tier.
subscriptions.hc.discount.days_before_end 7 integer Number of days before expiry when HC discount offers become available.
subscriptions.hc.discount.enabled 1 boolean Enable discounted HC renewal offers.
subscriptions.hc.payday.creditsspent_reset_on_expire 1 boolean Reset tracked credits spent when the HC subscription expires.
subscriptions.hc.payday.currency credits string Currency rewarded by the HC payday system.
subscriptions.hc.payday.enabled 1 boolean Enable the HC payday reward system.
subscriptions.hc.payday.interval 1 month string Date interval used between HC payday reward runs.
subscriptions.hc.payday.next_date 2020-10-15 00:00:00 string Next scheduled execution date for HC payday rewards.
subscriptions.hc.payday.percentage 10 integer Percentage of eligible spending returned by HC payday.
subscriptions.hc.payday.streak 7=5;30=10;60=15;90=20;180=25;365=30 list Semicolon-separated streak thresholds and rewards for HC payday.
subscriptions.scheduler.enabled 1 boolean Enable the subscription background scheduler.
subscriptions.scheduler.interval 10 integer Interval in minutes between subscription scheduler runs.

team

Compatibility markers for team or wired integrations.

Key Default value Type Purpose
team.wired.update.rc-1 DO NOT REMOVE THIS SETTING! string Compatibility marker used by the custom team wired implementation. Do not remove.

youtube

YouTube integration credentials.

Key Default value Type Purpose
youtube.apikey `` string API key used by the YouTube integration.