mcdex 0.1.0.dev0__py3-none-any.whl

mcdex/frog_variants/__init__.py

@@ -0,0 +1,16 @@
+"""
+The 'mcdex.frog_variants' package provides the frog variants of the game: the
+'MCFrogVariants' catalogue, an enumeration of every frog variant of the data
+file 'frog_variants.json' that ships with the package.
+
+- MCFrogVariants
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from ._mc_frog_variants import MCFrogVariants
+
+__all__ = (
+  'MCFrogVariants',
+)

mcdex/frog_variants/_mc_frog_variants.py

@@ -0,0 +1,47 @@
+"""
+MCFrogVariants is the catalogue of the game's frog variants: an enumeration
+with one member for every frog variant of the data file that ships with mcdex,
+each the same frog variant in every version, with the id each version knows it
+by: what /summon takes for a frog of that variant.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import FrogVariantId, MCThing
+
+
+class MCFrogVariants(MCThing):
+  """
+  The catalogue of the game's frog variants, each a member, found by its name
+  in capitals, in any case, or by its unique name:
+
+    warm = MCFrogVariants.WARM
+    warm is MCFrogVariants['warm']  # True
+    warm['1.19']
+    # FrogVariantId('warm', 'minecraft:frog{variant:"minecraft:warm"}')
+    len(MCFrogVariants)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'frog_variants.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'frog_variants.json'
+  __data_key__ = 'frog_variants'
+  __id_class__ = FrogVariantId
+  __kind__ = 'frog variant'
+
+  #  Members, one for every name of 'frog_variants.json'
+  COLD = Kee[str]('cold')
+  TEMPERATE = Kee[str]('temperate')
+  WARM = Kee[str]('warm')

mcdex/frog_variants/frog_variants.json

@@ -0,0 +1,29 @@
+{
+ "covers": [
+  "1.7.2",
+  "26.3"
+ ],
+ "legend": {
+  "": "vanilla has no such frog variant in this version"
+ },
+ "frog_variants": {
+  "cold": {
+   "ids": {
+    "1.7.2": "",
+    "1.19": "minecraft:frog{variant:\"minecraft:cold\"}"
+   }
+  },
+  "temperate": {
+   "ids": {
+    "1.7.2": "",
+    "1.19": "minecraft:frog{variant:\"minecraft:temperate\"}"
+   }
+  },
+  "warm": {
+   "ids": {
+    "1.7.2": "",
+    "1.19": "minecraft:frog{variant:\"minecraft:warm\"}"
+   }
+  }
+ }
+}

mcdex/game_rules/__init__.py

@@ -0,0 +1,16 @@
+"""
+The 'mcdex.game_rules' package provides the game rules of the game: the
+'MCGameRules' catalogue, an enumeration of every game rule of the data file
+'game_rules.json' that ships with the package.
+
+- MCGameRules
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from ._mc_game_rules import MCGameRules
+
+__all__ = (
+  'MCGameRules',
+)

mcdex/game_rules/_mc_game_rules.py

@@ -0,0 +1,110 @@
+"""
+MCGameRules is the catalogue of the game's game rules: an enumeration with one
+member for every game rule of the data file that ships with mcdex, each the
+same game rule in every version, with the id each version knows it by:
+what /gamerule takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import GameRuleId, MCThing
+
+
+class MCGameRules(MCThing):
+  """
+  The catalogue of the game's game rules, each a member, found by its name in
+  capitals, in any case, or by its unique name:
+
+    keepInventory = MCGameRules.KEEP_INVENTORY
+    keepInventory is MCGameRules['keep_inventory']  # True
+    keepInventory['1.12.2']  # GameRuleId('keep_inventory', 'keepInventory')
+    len(MCGameRules)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'game_rules.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'game_rules.json'
+  __data_key__ = 'game_rules'
+  __id_class__ = GameRuleId
+  __kind__ = 'game rule'
+
+  #  Members, one for every name of 'game_rules.json'
+  ADVANCE_TIME = Kee[str]('advance_time')
+  ADVANCE_WEATHER = Kee[str]('advance_weather')
+  ALLOW_ENTERING_NETHER_USING_PORTALS = Kee[str](
+    'allow_entering_nether_using_portals')
+  ALLOW_FIRE_TICKS_AWAY_FROM_PLAYER = Kee[str](
+    'allow_fire_ticks_away_from_player')
+  BLOCK_DROPS = Kee[str]('block_drops')
+  BLOCK_EXPLOSION_DROP_DECAY = Kee[str]('block_explosion_drop_decay')
+  COMMAND_BLOCK_OUTPUT = Kee[str]('command_block_output')
+  COMMAND_BLOCKS_WORK = Kee[str]('command_blocks_work')
+  DROWNING_DAMAGE = Kee[str]('drowning_damage')
+  ELYTRA_MOVEMENT_CHECK = Kee[str]('elytra_movement_check')
+  ENDER_PEARLS_VANISH_ON_DEATH = Kee[str]('ender_pearls_vanish_on_death')
+  ENTITY_DROPS = Kee[str]('entity_drops')
+  FALL_DAMAGE = Kee[str]('fall_damage')
+  FIRE_DAMAGE = Kee[str]('fire_damage')
+  FIRE_SPREAD_RADIUS_AROUND_PLAYER = Kee[str](
+    'fire_spread_radius_around_player')
+  FORGIVE_DEAD_PLAYERS = Kee[str]('forgive_dead_players')
+  FREEZE_DAMAGE = Kee[str]('freeze_damage')
+  GAME_LOOP_FUNCTION = Kee[str]('game_loop_function')
+  GLOBAL_SOUND_EVENTS = Kee[str]('global_sound_events')
+  IMMEDIATE_RESPAWN = Kee[str]('immediate_respawn')
+  KEEP_INVENTORY = Kee[str]('keep_inventory')
+  LAVA_SOURCE_CONVERSION = Kee[str]('lava_source_conversion')
+  LIMITED_CRAFTING = Kee[str]('limited_crafting')
+  LOCATOR_BAR = Kee[str]('locator_bar')
+  LOG_ADMIN_COMMANDS = Kee[str]('log_admin_commands')
+  MAX_BLOCK_MODIFICATIONS = Kee[str]('max_block_modifications')
+  MAX_COMMAND_FORKS = Kee[str]('max_command_forks')
+  MAX_COMMAND_SEQUENCE_LENGTH = Kee[str]('max_command_sequence_length')
+  MAX_ENTITY_CRAMMING = Kee[str]('max_entity_cramming')
+  MAX_MINECART_SPEED = Kee[str]('max_minecart_speed')
+  MAX_SNOW_ACCUMULATION_HEIGHT = Kee[str]('max_snow_accumulation_height')
+  MOB_DROPS = Kee[str]('mob_drops')
+  MOB_EXPLOSION_DROP_DECAY = Kee[str]('mob_explosion_drop_decay')
+  MOB_GRIEFING = Kee[str]('mob_griefing')
+  NATURAL_HEALTH_REGENERATION = Kee[str]('natural_health_regeneration')
+  PLAYER_MOVEMENT_CHECK = Kee[str]('player_movement_check')
+  PLAYERS_NETHER_PORTAL_CREATIVE_DELAY = Kee[str](
+    'players_nether_portal_creative_delay')
+  PLAYERS_NETHER_PORTAL_DEFAULT_DELAY = Kee[str](
+    'players_nether_portal_default_delay')
+  PLAYERS_SLEEPING_PERCENTAGE = Kee[str]('players_sleeping_percentage')
+  PROJECTILES_CAN_BREAK_BLOCKS = Kee[str]('projectiles_can_break_blocks')
+  PVP = Kee[str]('pvp')
+  RAIDS = Kee[str]('raids')
+  RANDOM_TICK_SPEED = Kee[str]('random_tick_speed')
+  REDUCED_DEBUG_INFO = Kee[str]('reduced_debug_info')
+  RESPAWN_RADIUS = Kee[str]('respawn_radius')
+  SEND_COMMAND_FEEDBACK = Kee[str]('send_command_feedback')
+  SHOW_ADVANCEMENT_MESSAGES = Kee[str]('show_advancement_messages')
+  SHOW_DEATH_MESSAGES = Kee[str]('show_death_messages')
+  SPAWN_CHUNK_RADIUS = Kee[str]('spawn_chunk_radius')
+  SPAWN_MOBS = Kee[str]('spawn_mobs')
+  SPAWN_MONSTERS = Kee[str]('spawn_monsters')
+  SPAWN_PATROLS = Kee[str]('spawn_patrols')
+  SPAWN_PHANTOMS = Kee[str]('spawn_phantoms')
+  SPAWN_WANDERING_TRADERS = Kee[str]('spawn_wandering_traders')
+  SPAWN_WARDENS = Kee[str]('spawn_wardens')
+  SPAWNER_BLOCKS_WORK = Kee[str]('spawner_blocks_work')
+  SPECTATORS_GENERATE_CHUNKS = Kee[str]('spectators_generate_chunks')
+  SPREAD_VINES = Kee[str]('spread_vines')
+  TNT_EXPLODES = Kee[str]('tnt_explodes')
+  TNT_EXPLOSION_DROP_DECAY = Kee[str]('tnt_explosion_drop_decay')
+  UNIVERSAL_ANGER = Kee[str]('universal_anger')
+  WATER_SOURCE_CONVERSION = Kee[str]('water_source_conversion')

mcdex/game_rules/game_rules.json

@@ -0,0 +1,436 @@
+{
+ "covers": [
+  "1.7.2",
+  "26.3"
+ ],
+ "legend": {
+  "": "vanilla has no such game rule in this version"
+ },
+ "game_rules": {
+  "advance_time": {
+   "ids": {
+    "1.7.2": "doDaylightCycle",
+    "1.21.11": "minecraft:advance_time"
+   }
+  },
+  "advance_weather": {
+   "ids": {
+    "1.7.2": "",
+    "1.11": "doWeatherCycle",
+    "1.21.11": "minecraft:advance_weather"
+   }
+  },
+  "allow_entering_nether_using_portals": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.9": "allowEnteringNetherUsingPortals",
+    "1.21.11": "minecraft:allow_entering_nether_using_portals"
+   }
+  },
+  "allow_fire_ticks_away_from_player": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.5": "allowFireTicksAwayFromPlayer",
+    "1.21.11": ""
+   }
+  },
+  "block_drops": {
+   "ids": {
+    "1.7.2": "doTileDrops",
+    "1.21.11": "minecraft:block_drops"
+   }
+  },
+  "block_explosion_drop_decay": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "blockExplosionDropDecay",
+    "1.21.11": "minecraft:block_explosion_drop_decay"
+   }
+  },
+  "command_block_output": {
+   "ids": {
+    "1.7.2": "commandBlockOutput",
+    "1.21.11": "minecraft:command_block_output"
+   }
+  },
+  "command_blocks_work": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.9": "commandBlocksEnabled",
+    "1.21.11": "minecraft:command_blocks_work"
+   }
+  },
+  "drowning_damage": {
+   "ids": {
+    "1.7.2": "",
+    "1.15": "drowningDamage",
+    "1.21.11": "minecraft:drowning_damage"
+   }
+  },
+  "elytra_movement_check": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "disableElytraMovementCheck",
+    "1.21.11": "minecraft:elytra_movement_check"
+   }
+  },
+  "ender_pearls_vanish_on_death": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.2": "enderPearlsVanishOnDeath",
+    "1.21.11": "minecraft:ender_pearls_vanish_on_death"
+   }
+  },
+  "entity_drops": {
+   "ids": {
+    "1.7.2": "",
+    "1.8.1": "doEntityDrops",
+    "1.21.11": "minecraft:entity_drops"
+   }
+  },
+  "fall_damage": {
+   "ids": {
+    "1.7.2": "",
+    "1.15": "fallDamage",
+    "1.21.11": "minecraft:fall_damage"
+   }
+  },
+  "fire_damage": {
+   "ids": {
+    "1.7.2": "",
+    "1.15": "fireDamage",
+    "1.21.11": "minecraft:fire_damage"
+   }
+  },
+  "fire_spread_radius_around_player": {
+   "ids": {
+    "1.7.2": "doFireTick",
+    "1.21.11": "minecraft:fire_spread_radius_around_player"
+   }
+  },
+  "forgive_dead_players": {
+   "ids": {
+    "1.7.2": "",
+    "1.16": "forgiveDeadPlayers",
+    "1.21.11": "minecraft:forgive_dead_players"
+   }
+  },
+  "freeze_damage": {
+   "ids": {
+    "1.7.2": "",
+    "1.17": "freezeDamage",
+    "1.21.11": "minecraft:freeze_damage"
+   }
+  },
+  "game_loop_function": {
+   "ids": {
+    "1.7.2": "",
+    "1.12": "gameLoopFunction",
+    "1.13": ""
+   }
+  },
+  "global_sound_events": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "globalSoundEvents",
+    "1.21.11": "minecraft:global_sound_events"
+   }
+  },
+  "immediate_respawn": {
+   "ids": {
+    "1.7.2": "",
+    "1.15": "doImmediateRespawn",
+    "1.21.11": "minecraft:immediate_respawn"
+   }
+  },
+  "keep_inventory": {
+   "ids": {
+    "1.7.2": "keepInventory",
+    "1.21.11": "minecraft:keep_inventory"
+   }
+  },
+  "lava_source_conversion": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "lavaSourceConversion",
+    "1.21.11": "minecraft:lava_source_conversion"
+   }
+  },
+  "limited_crafting": {
+   "ids": {
+    "1.7.2": "",
+    "1.12": "doLimitedCrafting",
+    "1.21.11": "minecraft:limited_crafting"
+   }
+  },
+  "locator_bar": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.6": "locatorBar",
+    "1.21.11": "minecraft:locator_bar"
+   }
+  },
+  "log_admin_commands": {
+   "ids": {
+    "1.7.2": "",
+    "1.8": "logAdminCommands",
+    "1.21.11": "minecraft:log_admin_commands"
+   }
+  },
+  "max_block_modifications": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "commandModificationBlockLimit",
+    "1.21.11": "minecraft:max_block_modifications"
+   }
+  },
+  "max_command_forks": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.3": "maxCommandForkCount",
+    "1.21.11": "minecraft:max_command_forks"
+   }
+  },
+  "max_command_sequence_length": {
+   "ids": {
+    "1.7.2": "",
+    "1.12": "maxCommandChainLength",
+    "1.21.11": "minecraft:max_command_sequence_length"
+   }
+  },
+  "max_entity_cramming": {
+   "ids": {
+    "1.7.2": "",
+    "1.11": "maxEntityCramming",
+    "1.21.11": "minecraft:max_entity_cramming"
+   }
+  },
+  "max_minecart_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.2": "minecartMaxSpeed",
+    "1.21.11": "minecraft:max_minecart_speed"
+   }
+  },
+  "max_snow_accumulation_height": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "snowAccumulationHeight",
+    "1.21.11": "minecraft:max_snow_accumulation_height"
+   }
+  },
+  "mob_drops": {
+   "ids": {
+    "1.7.2": "doMobLoot",
+    "1.21.11": "minecraft:mob_drops"
+   }
+  },
+  "mob_explosion_drop_decay": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "mobExplosionDropDecay",
+    "1.21.11": "minecraft:mob_explosion_drop_decay"
+   }
+  },
+  "mob_griefing": {
+   "ids": {
+    "1.7.2": "mobGriefing",
+    "1.21.11": "minecraft:mob_griefing"
+   }
+  },
+  "natural_health_regeneration": {
+   "ids": {
+    "1.7.2": "naturalRegeneration",
+    "1.21.11": "minecraft:natural_health_regeneration"
+   }
+  },
+  "player_movement_check": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.2": "disablePlayerMovementCheck",
+    "1.21.11": "minecraft:player_movement_check"
+   }
+  },
+  "players_nether_portal_creative_delay": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.3": "playersNetherPortalCreativeDelay",
+    "1.21.11": "minecraft:players_nether_portal_creative_delay"
+   }
+  },
+  "players_nether_portal_default_delay": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.3": "playersNetherPortalDefaultDelay",
+    "1.21.11": "minecraft:players_nether_portal_default_delay"
+   }
+  },
+  "players_sleeping_percentage": {
+   "ids": {
+    "1.7.2": "",
+    "1.17": "playersSleepingPercentage",
+    "1.21.11": "minecraft:players_sleeping_percentage"
+   }
+  },
+  "projectiles_can_break_blocks": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.3": "projectilesCanBreakBlocks",
+    "1.21.11": "minecraft:projectiles_can_break_blocks"
+   }
+  },
+  "pvp": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.9": "pvp",
+    "1.21.11": "minecraft:pvp"
+   }
+  },
+  "raids": {
+   "ids": {
+    "1.7.2": "",
+    "1.14.3": "disableRaids",
+    "1.21.11": "minecraft:raids"
+   }
+  },
+  "random_tick_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.8": "randomTickSpeed",
+    "1.21.11": "minecraft:random_tick_speed"
+   }
+  },
+  "reduced_debug_info": {
+   "ids": {
+    "1.7.2": "",
+    "1.8": "reducedDebugInfo",
+    "1.21.11": "minecraft:reduced_debug_info"
+   }
+  },
+  "respawn_radius": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "spawnRadius",
+    "1.21.11": "minecraft:respawn_radius"
+   }
+  },
+  "send_command_feedback": {
+   "ids": {
+    "1.7.2": "",
+    "1.8": "sendCommandFeedback",
+    "1.21.11": "minecraft:send_command_feedback"
+   }
+  },
+  "show_advancement_messages": {
+   "ids": {
+    "1.7.2": "",
+    "1.12": "announceAdvancements",
+    "1.21.11": "minecraft:show_advancement_messages"
+   }
+  },
+  "show_death_messages": {
+   "ids": {
+    "1.7.2": "",
+    "1.8": "showDeathMessages",
+    "1.21.11": "minecraft:show_death_messages"
+   }
+  },
+  "spawn_chunk_radius": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "spawnChunkRadius",
+    "1.21.9": ""
+   }
+  },
+  "spawn_mobs": {
+   "ids": {
+    "1.7.2": "doMobSpawning",
+    "1.21.11": "minecraft:spawn_mobs"
+   }
+  },
+  "spawn_monsters": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.9": "spawnMonsters",
+    "1.21.11": "minecraft:spawn_monsters"
+   }
+  },
+  "spawn_patrols": {
+   "ids": {
+    "1.7.2": "",
+    "1.15.2": "doPatrolSpawning",
+    "1.21.11": "minecraft:spawn_patrols"
+   }
+  },
+  "spawn_phantoms": {
+   "ids": {
+    "1.7.2": "",
+    "1.15": "doInsomnia",
+    "1.21.11": "minecraft:spawn_phantoms"
+   }
+  },
+  "spawn_wandering_traders": {
+   "ids": {
+    "1.7.2": "",
+    "1.15.2": "doTraderSpawning",
+    "1.21.11": "minecraft:spawn_wandering_traders"
+   }
+  },
+  "spawn_wardens": {
+   "ids": {
+    "1.7.2": "",
+    "1.19": "doWardenSpawning",
+    "1.21.11": "minecraft:spawn_wardens"
+   }
+  },
+  "spawner_blocks_work": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.9": "spawnerBlocksEnabled",
+    "1.21.11": "minecraft:spawner_blocks_work"
+   }
+  },
+  "spectators_generate_chunks": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "spectatorsGenerateChunks",
+    "1.21.11": "minecraft:spectators_generate_chunks"
+   }
+  },
+  "spread_vines": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "doVinesSpread",
+    "1.21.11": "minecraft:spread_vines"
+   }
+  },
+  "tnt_explodes": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.5": "tntExplodes",
+    "1.21.11": "minecraft:tnt_explodes"
+   }
+  },
+  "tnt_explosion_drop_decay": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "tntExplosionDropDecay",
+    "1.21.11": "minecraft:tnt_explosion_drop_decay"
+   }
+  },
+  "universal_anger": {
+   "ids": {
+    "1.7.2": "",
+    "1.16": "universalAnger",
+    "1.21.11": "minecraft:universal_anger"
+   }
+  },
+  "water_source_conversion": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.3": "waterSourceConversion",
+    "1.21.11": "minecraft:water_source_conversion"
+   }
+  }
+ }
+}

mcdex/items/__init__.py

@@ -0,0 +1,16 @@
+"""
+The 'mcdex.items' package provides the items of the game: the
+'MCItems' catalogue, an enumeration of every item of the data file
+'items.json' that ships with the package.
+
+- MCItems
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from ._mc_items import MCItems
+
+__all__ = (
+  'MCItems',
+)