Migrating from v1
What changed¶
v2 is a ground-up rebuild, not an update. The panel, the command system and the cross-server layer are all new. The two changes you'll feel first: ranks have become roles, and the Settings script has become live in-game configuration, so most things that once meant editing a script and republishing can now be changed from the panel while your game is running.
Ranks are now roles¶
v1 gave you a fixed ladder of six ranks: NonAdmin (0), VIP (1), Mod (2), Admin (3), HeadAdmin (4) and Owner (5). You could rename them, but you could never add a seventh.
v2 replaces the ladder with named roles. The default set is Player, Fun, Mod, Admin, Dev and Owner, and you can create as many more as you like, either as modules under Config > Roles or live from the panel. Seniority comes from the role order rather than a fixed number, so reordering the list changes who outranks who.
Where your v1 settings go¶
Here's where the things you'd normally reach for in the v1 Settings script now live:
| v1 | v2 |
|---|---|
Ranks (specific users) |
giveToUsers on the matching role |
Gamepasses and Assets |
giveToProducts |
Groups |
giveToGroups |
FreeAdmin |
giveToEveryone |
Banned list |
Config > Bans |
SetCommandRankByName / SetCommandRankByTag |
command tags matched by a role's inheritCommandsWithTags |
RankRequiredToViewPage |
mayViewPages on each role |
Cmdbar rank |
the CommandBar page in mayViewPages |
;permRank |
permanent role grants from the panel |
Custom Config > Commands scripts |
the new command module format, see Creating Commands |
AppTheme |
Config > Themes |
_G.HDAdminMain |
the new API |
Your data does not carry over¶
Warning
v1 keeps its bans and perm ranks in its own datastores, and v2 does not read them. Re-enter your bans in Config > Bans or through the Bans page, and re-grant permanent roles to your staff. Personal player settings like themes and prefixes also reset.
Upgrading an existing game¶
v2 ships as the same HD Admin model, and games running v1 today keep running v1 for now. When you're ready to move, take the latest model, remove your old copy and set up your roles fresh using the table above. Only run one HD Admin in a game at a time; if two try to start, the second refuses to initialise.
Warning
Support for v1 is being discontinued in 2028, and v1 will stop working after that. Make sure your game has moved over to v2 before then.