mcdex 0.1.0.dev0__py3-none-any.whl

mcdex/damage_types/_mc_damage_types.py

@@ -0,0 +1,94 @@
+"""
+MCDamageTypes is the catalogue of the game's damage types: an enumeration with
+one member for every damage type of the data file that ships with mcdex, each
+the same damage type in every version, with the id each version knows it by:
+what /damage takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import DamageTypeId, MCThing
+
+
+class MCDamageTypes(MCThing):
+  """
+  The catalogue of the game's damage types, each a member, found by its name in
+  capitals, in any case, or by its unique name:
+
+    inFire = MCDamageTypes.IN_FIRE
+    inFire is MCDamageTypes['in_fire']  # True
+    inFire['1.19.4']  # DamageTypeId('in_fire', 'minecraft:in_fire')
+    len(MCDamageTypes)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'damage_types.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'damage_types.json'
+  __data_key__ = 'damage_types'
+  __id_class__ = DamageTypeId
+  __kind__ = 'damage type'
+
+  #  Members, one for every name of 'damage_types.json'
+  ARROW = Kee[str]('arrow')
+  BAD_RESPAWN_POINT = Kee[str]('bad_respawn_point')
+  CACTUS = Kee[str]('cactus')
+  CAMPFIRE = Kee[str]('campfire')
+  CRAMMING = Kee[str]('cramming')
+  DRAGON_BREATH = Kee[str]('dragon_breath')
+  DROWN = Kee[str]('drown')
+  DRY_OUT = Kee[str]('dry_out')
+  ENDER_PEARL = Kee[str]('ender_pearl')
+  EXPLOSION = Kee[str]('explosion')
+  FALL = Kee[str]('fall')
+  FALLING_ANVIL = Kee[str]('falling_anvil')
+  FALLING_BLOCK = Kee[str]('falling_block')
+  FALLING_STALACTITE = Kee[str]('falling_stalactite')
+  FIREBALL = Kee[str]('fireball')
+  FIREWORKS = Kee[str]('fireworks')
+  FLY_INTO_WALL = Kee[str]('fly_into_wall')
+  FREEZE = Kee[str]('freeze')
+  GENERIC = Kee[str]('generic')
+  GENERIC_KILL = Kee[str]('generic_kill')
+  HOT_FLOOR = Kee[str]('hot_floor')
+  IN_FIRE = Kee[str]('in_fire')
+  IN_WALL = Kee[str]('in_wall')
+  INDIRECT_MAGIC = Kee[str]('indirect_magic')
+  LAVA = Kee[str]('lava')
+  LIGHTNING_BOLT = Kee[str]('lightning_bolt')
+  MACE_SMASH = Kee[str]('mace_smash')
+  MAGIC = Kee[str]('magic')
+  MOB_ATTACK = Kee[str]('mob_attack')
+  MOB_ATTACK_NO_AGGRO = Kee[str]('mob_attack_no_aggro')
+  MOB_PROJECTILE = Kee[str]('mob_projectile')
+  ON_FIRE = Kee[str]('on_fire')
+  OUT_OF_WORLD = Kee[str]('out_of_world')
+  OUTSIDE_BORDER = Kee[str]('outside_border')
+  PLAYER_ATTACK = Kee[str]('player_attack')
+  PLAYER_EXPLOSION = Kee[str]('player_explosion')
+  SONIC_BOOM = Kee[str]('sonic_boom')
+  SPEAR = Kee[str]('spear')
+  SPIT = Kee[str]('spit')
+  STALAGMITE = Kee[str]('stalagmite')
+  STARVE = Kee[str]('starve')
+  STING = Kee[str]('sting')
+  SULFUR_CUBE_HOT = Kee[str]('sulfur_cube_hot')
+  SWEET_BERRY_BUSH = Kee[str]('sweet_berry_bush')
+  THORNS = Kee[str]('thorns')
+  THROWN = Kee[str]('thrown')
+  TRIDENT = Kee[str]('trident')
+  UNATTRIBUTED_FIREBALL = Kee[str]('unattributed_fireball')
+  WIND_CHARGE = Kee[str]('wind_charge')
+  WITHER = Kee[str]('wither')
+  WITHER_SKULL = Kee[str]('wither_skull')

mcdex/damage_types/damage_types.json

@@ -0,0 +1,317 @@
+{
+ "covers": [
+  "1.7.2",
+  "26.3"
+ ],
+ "legend": {
+  "": "vanilla has no such damage type in this version"
+ },
+ "damage_types": {
+  "arrow": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:arrow"
+   }
+  },
+  "bad_respawn_point": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:bad_respawn_point"
+   }
+  },
+  "cactus": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:cactus"
+   }
+  },
+  "campfire": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:campfire"
+   }
+  },
+  "cramming": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:cramming"
+   }
+  },
+  "dragon_breath": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:dragon_breath"
+   }
+  },
+  "drown": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:drown"
+   }
+  },
+  "dry_out": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:dry_out"
+   }
+  },
+  "ender_pearl": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.2": "minecraft:ender_pearl"
+   }
+  },
+  "explosion": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:explosion"
+   }
+  },
+  "fall": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:fall"
+   }
+  },
+  "falling_anvil": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:falling_anvil"
+   }
+  },
+  "falling_block": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:falling_block"
+   }
+  },
+  "falling_stalactite": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:falling_stalactite"
+   }
+  },
+  "fireball": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:fireball"
+   }
+  },
+  "fireworks": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:fireworks"
+   }
+  },
+  "fly_into_wall": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:fly_into_wall"
+   }
+  },
+  "freeze": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:freeze"
+   }
+  },
+  "generic": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:generic"
+   }
+  },
+  "generic_kill": {
+   "ids": {
+    "1.7.2": "",
+    "1.20": "minecraft:generic_kill"
+   }
+  },
+  "hot_floor": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:hot_floor"
+   }
+  },
+  "in_fire": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:in_fire"
+   }
+  },
+  "in_wall": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:in_wall"
+   }
+  },
+  "indirect_magic": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:indirect_magic"
+   }
+  },
+  "lava": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:lava"
+   }
+  },
+  "lightning_bolt": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:lightning_bolt"
+   }
+  },
+  "mace_smash": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.2": "minecraft:mace_smash"
+   }
+  },
+  "magic": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:magic"
+   }
+  },
+  "mob_attack": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:mob_attack"
+   }
+  },
+  "mob_attack_no_aggro": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:mob_attack_no_aggro"
+   }
+  },
+  "mob_projectile": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:mob_projectile"
+   }
+  },
+  "on_fire": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:on_fire"
+   }
+  },
+  "out_of_world": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:out_of_world"
+   }
+  },
+  "outside_border": {
+   "ids": {
+    "1.7.2": "",
+    "1.20": "minecraft:outside_border"
+   }
+  },
+  "player_attack": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:player_attack"
+   }
+  },
+  "player_explosion": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:player_explosion"
+   }
+  },
+  "sonic_boom": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:sonic_boom"
+   }
+  },
+  "spear": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.11": "minecraft:spear"
+   }
+  },
+  "spit": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:spit"
+   }
+  },
+  "stalagmite": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:stalagmite"
+   }
+  },
+  "starve": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:starve"
+   }
+  },
+  "sting": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:sting"
+   }
+  },
+  "sulfur_cube_hot": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:sulfur_cube_hot"
+   }
+  },
+  "sweet_berry_bush": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:sweet_berry_bush"
+   }
+  },
+  "thorns": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:thorns"
+   }
+  },
+  "thrown": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:thrown"
+   }
+  },
+  "trident": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:trident"
+   }
+  },
+  "unattributed_fireball": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:unattributed_fireball"
+   }
+  },
+  "wind_charge": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:wind_charge"
+   }
+  },
+  "wither": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:wither"
+   }
+  },
+  "wither_skull": {
+   "ids": {
+    "1.7.2": "",
+    "1.19.4": "minecraft:wither_skull"
+   }
+  }
+ }
+}

mcdex/dimensions/__init__.py

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

mcdex/dimensions/_mc_dimensions.py

@@ -0,0 +1,46 @@
+"""
+MCDimensions is the catalogue of the game's dimensions: an enumeration with one
+member for every dimension of the data file that ships with mcdex, each the
+same dimension in every version, with the id each version knows it by:
+what /execute in takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import DimensionId, MCThing
+
+
+class MCDimensions(MCThing):
+  """
+  The catalogue of the game's dimensions, each a member, found by its name in
+  capitals, in any case, or by its unique name:
+
+    theNether = MCDimensions.THE_NETHER
+    theNether is MCDimensions['the_nether']  # True
+    theNether['1.12.2']  # DimensionId('the_nether', '-1')
+    len(MCDimensions)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'dimensions.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'dimensions.json'
+  __data_key__ = 'dimensions'
+  __id_class__ = DimensionId
+  __kind__ = 'dimension'
+
+  #  Members, one for every name of 'dimensions.json'
+  OVERWORLD = Kee[str]('overworld')
+  THE_END = Kee[str]('the_end')
+  THE_NETHER = Kee[str]('the_nether')

mcdex/dimensions/dimensions.json

@@ -0,0 +1,29 @@
+{
+ "covers": [
+  "1.7.2",
+  "26.3"
+ ],
+ "legend": {
+  "": "vanilla has no such dimension in this version"
+ },
+ "dimensions": {
+  "overworld": {
+   "ids": {
+    "1.7.2": "0",
+    "1.13": "minecraft:overworld"
+   }
+  },
+  "the_end": {
+   "ids": {
+    "1.7.2": "1",
+    "1.13": "minecraft:the_end"
+   }
+  },
+  "the_nether": {
+   "ids": {
+    "1.7.2": "-1",
+    "1.13": "minecraft:the_nether"
+   }
+  }
+ }
+}

mcdex/effects/__init__.py

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

mcdex/effects/_mc_effects.py

@@ -0,0 +1,83 @@
+"""
+MCEffects is the catalogue of the game's effects: an enumeration with one
+member for every effect of the data file that ships with mcdex, each the
+same effect in every version, with the id each version knows it by:
+what /effect takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import EffectId, MCThing
+
+
+class MCEffects(MCThing):
+  """
+  The catalogue of the game's effects, each a member, found by its name in
+  capitals, in any case, or by its unique name:
+
+    speed = MCEffects.SPEED
+    speed is MCEffects['speed']  # True
+    speed['1.7.10']  # EffectId('speed', '1')
+    len(MCEffects)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'effects.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'effects.json'
+  __data_key__ = 'effects'
+  __id_class__ = EffectId
+  __kind__ = 'effect'
+
+  #  Members, one for every name of 'effects.json'
+  ABSORPTION = Kee[str]('absorption')
+  BAD_OMEN = Kee[str]('bad_omen')
+  BLINDNESS = Kee[str]('blindness')
+  BREATH_OF_THE_NAUTILUS = Kee[str]('breath_of_the_nautilus')
+  CONDUIT_POWER = Kee[str]('conduit_power')
+  DARKNESS = Kee[str]('darkness')
+  DOLPHINS_GRACE = Kee[str]('dolphins_grace')
+  FIRE_RESISTANCE = Kee[str]('fire_resistance')
+  GLOWING = Kee[str]('glowing')
+  HASTE = Kee[str]('haste')
+  HEALTH_BOOST = Kee[str]('health_boost')
+  HERO_OF_THE_VILLAGE = Kee[str]('hero_of_the_village')
+  HUNGER = Kee[str]('hunger')
+  INFESTED = Kee[str]('infested')
+  INSTANT_DAMAGE = Kee[str]('instant_damage')
+  INSTANT_HEALTH = Kee[str]('instant_health')
+  INVISIBILITY = Kee[str]('invisibility')
+  JUMP_BOOST = Kee[str]('jump_boost')
+  LEVITATION = Kee[str]('levitation')
+  LUCK = Kee[str]('luck')
+  MINING_FATIGUE = Kee[str]('mining_fatigue')
+  NAUSEA = Kee[str]('nausea')
+  NIGHT_VISION = Kee[str]('night_vision')
+  OOZING = Kee[str]('oozing')
+  POISON = Kee[str]('poison')
+  RAID_OMEN = Kee[str]('raid_omen')
+  REGENERATION = Kee[str]('regeneration')
+  RESISTANCE = Kee[str]('resistance')
+  SATURATION = Kee[str]('saturation')
+  SLOW_FALLING = Kee[str]('slow_falling')
+  SLOWNESS = Kee[str]('slowness')
+  SPEED = Kee[str]('speed')
+  STRENGTH = Kee[str]('strength')
+  TRIAL_OMEN = Kee[str]('trial_omen')
+  UNLUCK = Kee[str]('unluck')
+  WATER_BREATHING = Kee[str]('water_breathing')
+  WEAKNESS = Kee[str]('weakness')
+  WEAVING = Kee[str]('weaving')
+  WIND_CHARGED = Kee[str]('wind_charged')
+  WITHER = Kee[str]('wither')