Cubees

Wiki/Owner Guide/Data, Backups & Variables

Data, Backups & Variables

Where CUBEES keeps player progress, authored content and settings, what to back up, and what deleting each piece would reset.

Nothing a player does is written into the Cubees pack files. Progress, authored content and your CUBEES Settings live in MythicMobs saved variables, in MythicMobs spawner files, in LuckPerms and in the world. The pack folders hold only content and defaults, and an update replaces them.

Where the data lives

  • plugins/MythicMobs/data/players/<uuid>.json: one file per player, holding everything CUBEES remembers about that player (player variables).
  • plugins/MythicMobs/data/global-data.json: everything shared by the whole server (global variables).
  • plugins/MythicMobs/spawners/: what is placed in the world. Habitat_<Design>_<id>.yml is a habitat, Inhabitant_cubee-<type>-<id>.yml a Cubee living in it, and Cubik_<n>.yml a placed Cubik.
  • LuckPerms: who owns which Cubee. Owning a Cubee is the permission cubee.pet.use.cubee-<id>, set by the shop, quest rewards, Cubik prizes and /cubee_give. LuckPerms keeps it in its own storage (on the reference server, the H2 database file in plugins/LuckPerms/).
  • The world folder: every item a player holds, including Cubits, snacks, coins and habitat licences.

Only player and global variables last. A Cubee's body is removed whenever it despawns and a new one is made when it is called out, so everything that must last is saved on its owner. MythicMobs files each variable under its literal name, in the entries section of these files.

Player variables

Keys ending in <id> exist once per Cubee type, for example cubee_name-fire.

  • cucoin and cucrystal: the two balances.
  • cubee_name-<id>, cubee_exp-<id>, cubee_exp_percent-<id> (EXP and vitality), cubee_health-<id> and cubee_max_health-<id>.
  • cubee_behavior-<id> and cubee_behavior_text-<id>: the Cubee's behaviour mode.
  • cubee_cube-<id> and cubee_cube_name-<id>: the Cube socketed in it.
  • cubee_respawn-cubee-<id>: when a fallen Cubee may be called again.
  • badge_<badge>-<id> and badge_tier_<badge>-<id>: badge progress and tier, for vitality, explore, snack, battle and ability.
  • cubee_combos_list and cubee_combos_equipping_index: the saved combos and which one is equipped.
  • cubee_allies: the players marked as allies.
  • cubee_habitat_index_<n>, cubee_habitat_ids_list, cubee_habitat_ids_keyvalue, cubee_inhabitant-<id> and cubee_inhabitant_id-<id>: the player's habitat plots and which Cubees live where.
  • quest_ongoing_*, squest_done_<n>, qdone_* and daily_quest_*: the quest in progress, finished quests and the player's Daily draw.
  • cubees_collected: how many Cubees the player owns, shown on the My Collection button.
  • social_link-<id> and dovey_letter: the link a player set on a Social Media Cubee, and the letter they wrote for the Lovey Dovey Cubee.
  • McPets edition only: cubee_mcpets_level-<id>, cubee_mcpets_exp-<id> and cubee_mcpets_next-<id>, a copy of the Cubee's MCPets level and EXP for its card, and cubee_mcpets_bank-<id>, the snack EXP it earned in a habitat, which reaches MCPets at its next summon.

Global variables

  • cubee_quest_<n>-<field>: the 225 Daily quest slots.
  • cubee_squest_<n>-<field>: the 576 Story quest slots.
  • cubee_daily_quest_count-<difficulty> and cubee_daily_quest_index-<difficulty>_<n>: the Daily draw index, which the quest editor rebuilds.
  • cubee_daily_reset_at: when the current Daily day ends.
  • cubee_shop_<category>_<n>-<field>: shop products and their sales, 225 per category (cubee, item, habitat, cubik).
  • cubik_<n>-<field>: the 225 Cubiks and their reward rows.
  • cubee_habitat_<id>-yaw: the way each placed habitat faces.
  • cubees_types-<n>, cubees_ability-<id> and cubees_expmax-<id>: a list of Cubee types that fills itself as Cubees are summoned.
  • cubees_collection_board and cubees_top_1 to cubees_top_5: the Top Collectors board on the My Collection button.

A quest, shop or Cubik slot counts as filled while its -exists entry is set.

Backing up

MythicMobs keeps these values in memory and writes them to disk as it runs and when it stops. A copy taken from a running server can be out of date, and a file put back under a running server is written over.

  1. Stop the server.
  2. Copy plugins/MythicMobs/data/, plugins/MythicMobs/spawners/, your LuckPerms storage and the world folders. In the McPets edition, also copy MCPets' own data: MCPets keeps each Cubee's level, EXP and health.
  3. Also copy any pack file you changed yourself, such as an edited placeholders.yml or presets you added to the Import skill files. A pack update replaces them.
  4. Keep dated copies, then start the server.

Restore the same way, with the server stopped, and restore the pieces together. A habitat lives in three places (its owner's player file, global-data.json and its spawner files), so restoring only one leaves it half there.

The two data files are shared with every other MythicMobs pack on your server, so backing them up or restoring them covers those packs too.

What a wipe would reset

Do all of these with the server stopped.

  • Deleting one player's file in data/players/: that player loses their CuCoins and CuCrystals, every Cubee's name, vitality, mode, Cube and badges, and their combos, allies, habitat plots and quest progress. They keep the Cubees they own (LuckPerms) and their items. Habitats they placed stay in the world with no record behind them; stand next to each and run /habitat_removespawner.
  • Deleting global-data.json: every Daily and Story quest, shop product and sale, Cubik and CUBEES Settings override is gone, and the Daily draw starts over. Players keep their own progress. Until a Cubee type has been summoned again, /cubee_exp_give refuses it.
  • A full CUBEES reset also means removing the habitat, inhabitant and Cubik spawner files and the cubee.pet.use.cubee-* permissions in LuckPerms.

Deleting either data file also wipes the saved variables of any other MythicMobs pack. To reset CUBEES alone, remove only the entries with the names listed above.

Changing one value

MythicMobs loads a player's file when they join and saves it when they leave, so these commands only work on a player who is online. The exceptions are /cubee_give and /cubee_take, which go through LuckPerms.

  • /cucoin_give, /cucoin_take and /cucoin_set <player> <amount>, and /cucoin_check <player>; the same four exist for CuCrystals as /cucrystal_give and so on (cubees.admin.currency).
  • /cubee_exp_give and /cubee_exp_give_percent <player> <type> <amount>; a negative amount lowers it (cubees.admin.cubee).
  • /cubadge_reset <player> <badge> <cubee>, where badge and cubee both accept all (cubees.admin.quest).
  • /cubee_give and /cubee_take <player> <type> grant and remove a Cubee, offline too (cubees.admin.cubee).
  • /habitat_delete for the habitat nearest you, or /habitat_delete index <player> <slot> (cubees.admin.habitat).
  • A CUBEES Settings override: right-click it in the panel.

To change an offline player's data, stop the server and edit their file.

Last updated on 10/16/2026, 11:14:53 PM