mcdex 0.1.0.dev0__py3-none-any.whl

mcdex/attributes/__init__.py

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

mcdex/attributes/_mc_attributes.py

@@ -0,0 +1,83 @@
+"""
+MCAttributes is the catalogue of the game's attributes: an enumeration with one
+member for every attribute of the data file that ships with mcdex, each the
+same attribute in every version, with the id each version knows it by:
+the name an entity's data gives it, and from 1.16 what /attribute takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import AttributeId, MCThing
+
+
+class MCAttributes(MCThing):
+  """
+  The catalogue of the game's attributes, each a member, found by its name in
+  capitals, in any case, or by its unique name:
+
+    maxHealth = MCAttributes.MAX_HEALTH
+    maxHealth is MCAttributes['max_health']  # True
+    maxHealth['1.15.2']  # AttributeId('max_health', 'generic.maxHealth')
+    len(MCAttributes)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'attributes.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'attributes.json'
+  __data_key__ = 'attributes'
+  __id_class__ = AttributeId
+  __kind__ = 'attribute'
+
+  #  Members, one for every name of 'attributes.json'
+  AIR_DRAG_MODIFIER = Kee[str]('air_drag_modifier')
+  ARMOR = Kee[str]('armor')
+  ARMOR_TOUGHNESS = Kee[str]('armor_toughness')
+  ATTACK_DAMAGE = Kee[str]('attack_damage')
+  ATTACK_KNOCKBACK = Kee[str]('attack_knockback')
+  ATTACK_SPEED = Kee[str]('attack_speed')
+  BELOW_NAME_DISTANCE = Kee[str]('below_name_distance')
+  BLOCK_BREAK_SPEED = Kee[str]('block_break_speed')
+  BLOCK_INTERACTION_RANGE = Kee[str]('block_interaction_range')
+  BOUNCINESS = Kee[str]('bounciness')
+  BURNING_TIME = Kee[str]('burning_time')
+  CAMERA_DISTANCE = Kee[str]('camera_distance')
+  ENTITY_INTERACTION_RANGE = Kee[str]('entity_interaction_range')
+  EXPLOSION_KNOCKBACK_RESISTANCE = Kee[str]('explosion_knockback_resistance')
+  FALL_DAMAGE_MULTIPLIER = Kee[str]('fall_damage_multiplier')
+  FLYING_SPEED = Kee[str]('flying_speed')
+  FOLLOW_RANGE = Kee[str]('follow_range')
+  FRICTION_MODIFIER = Kee[str]('friction_modifier')
+  GRAVITY = Kee[str]('gravity')
+  JUMP_STRENGTH = Kee[str]('jump_strength')
+  KNOCKBACK_RESISTANCE = Kee[str]('knockback_resistance')
+  LUCK = Kee[str]('luck')
+  MAX_ABSORPTION = Kee[str]('max_absorption')
+  MAX_HEALTH = Kee[str]('max_health')
+  MINING_EFFICIENCY = Kee[str]('mining_efficiency')
+  MOVEMENT_EFFICIENCY = Kee[str]('movement_efficiency')
+  MOVEMENT_SPEED = Kee[str]('movement_speed')
+  NAME_TAG_DISTANCE = Kee[str]('name_tag_distance')
+  OXYGEN_BONUS = Kee[str]('oxygen_bonus')
+  SAFE_FALL_DISTANCE = Kee[str]('safe_fall_distance')
+  SCALE = Kee[str]('scale')
+  SNEAKING_SPEED = Kee[str]('sneaking_speed')
+  SPAWN_REINFORCEMENTS = Kee[str]('spawn_reinforcements')
+  STEP_HEIGHT = Kee[str]('step_height')
+  SUBMERGED_MINING_SPEED = Kee[str]('submerged_mining_speed')
+  SWEEPING_DAMAGE_RATIO = Kee[str]('sweeping_damage_ratio')
+  TEMPT_RANGE = Kee[str]('tempt_range')
+  WATER_MOVEMENT_EFFICIENCY = Kee[str]('water_movement_efficiency')
+  WAYPOINT_RECEIVE_RANGE = Kee[str]('waypoint_receive_range')
+  WAYPOINT_TRANSMIT_RANGE = Kee[str]('waypoint_transmit_range')

mcdex/attributes/attributes.json

@@ -0,0 +1,289 @@
+{
+ "covers": [
+  "1.7.2",
+  "26.3"
+ ],
+ "legend": {
+  "": "vanilla has no such attribute in this version"
+ },
+ "attributes": {
+  "air_drag_modifier": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:air_drag_modifier"
+   }
+  },
+  "armor": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "generic.armor",
+    "1.16": "minecraft:generic.armor",
+    "1.21.2": "minecraft:armor"
+   }
+  },
+  "armor_toughness": {
+   "ids": {
+    "1.7.2": "",
+    "1.9.1": "generic.armorToughness",
+    "1.16": "minecraft:generic.armor_toughness",
+    "1.21.2": "minecraft:armor_toughness"
+   }
+  },
+  "attack_damage": {
+   "ids": {
+    "1.7.2": "generic.attackDamage",
+    "1.16": "minecraft:generic.attack_damage",
+    "1.21.2": "minecraft:attack_damage"
+   }
+  },
+  "attack_knockback": {
+   "ids": {
+    "1.7.2": "",
+    "1.14": "generic.attackKnockback",
+    "1.16": "minecraft:generic.attack_knockback",
+    "1.21.2": "minecraft:attack_knockback"
+   }
+  },
+  "attack_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "generic.attackSpeed",
+    "1.16": "minecraft:generic.attack_speed",
+    "1.21.2": "minecraft:attack_speed"
+   }
+  },
+  "below_name_distance": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:below_name_distance"
+   }
+  },
+  "block_break_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:player.block_break_speed",
+    "1.21.2": "minecraft:block_break_speed"
+   }
+  },
+  "block_interaction_range": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:player.block_interaction_range",
+    "1.21.2": "minecraft:block_interaction_range"
+   }
+  },
+  "bounciness": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:bounciness"
+   }
+  },
+  "burning_time": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:generic.burning_time",
+    "1.21.2": "minecraft:burning_time"
+   }
+  },
+  "camera_distance": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.6": "minecraft:camera_distance"
+   }
+  },
+  "entity_interaction_range": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:player.entity_interaction_range",
+    "1.21.2": "minecraft:entity_interaction_range"
+   }
+  },
+  "explosion_knockback_resistance": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:generic.explosion_knockback_resistance",
+    "1.21.2": "minecraft:explosion_knockback_resistance"
+   }
+  },
+  "fall_damage_multiplier": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:generic.fall_damage_multiplier",
+    "1.21.2": "minecraft:fall_damage_multiplier"
+   }
+  },
+  "flying_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.12": "generic.flyingSpeed",
+    "1.16": "minecraft:generic.flying_speed",
+    "1.21.2": "minecraft:flying_speed"
+   }
+  },
+  "follow_range": {
+   "ids": {
+    "1.7.2": "generic.followRange",
+    "1.16": "minecraft:generic.follow_range",
+    "1.21.2": "minecraft:follow_range"
+   }
+  },
+  "friction_modifier": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:friction_modifier"
+   }
+  },
+  "gravity": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:generic.gravity",
+    "1.21.2": "minecraft:gravity"
+   }
+  },
+  "jump_strength": {
+   "ids": {
+    "1.7.2": "horse.jumpStrength",
+    "1.16": "minecraft:horse.jump_strength",
+    "1.20.5": "minecraft:generic.jump_strength",
+    "1.21.2": "minecraft:jump_strength"
+   }
+  },
+  "knockback_resistance": {
+   "ids": {
+    "1.7.2": "generic.knockbackResistance",
+    "1.16": "minecraft:generic.knockback_resistance",
+    "1.21.2": "minecraft:knockback_resistance"
+   }
+  },
+  "luck": {
+   "ids": {
+    "1.7.2": "",
+    "1.9": "generic.luck",
+    "1.16": "minecraft:generic.luck",
+    "1.21.2": "minecraft:luck"
+   }
+  },
+  "max_absorption": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.2": "minecraft:generic.max_absorption",
+    "1.21.2": "minecraft:max_absorption"
+   }
+  },
+  "max_health": {
+   "ids": {
+    "1.7.2": "generic.maxHealth",
+    "1.16": "minecraft:generic.max_health",
+    "1.21.2": "minecraft:max_health"
+   }
+  },
+  "mining_efficiency": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:player.mining_efficiency",
+    "1.21.2": "minecraft:mining_efficiency"
+   }
+  },
+  "movement_efficiency": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:generic.movement_efficiency",
+    "1.21.2": "minecraft:movement_efficiency"
+   }
+  },
+  "movement_speed": {
+   "ids": {
+    "1.7.2": "generic.movementSpeed",
+    "1.16": "minecraft:generic.movement_speed",
+    "1.21.2": "minecraft:movement_speed"
+   }
+  },
+  "name_tag_distance": {
+   "ids": {
+    "1.7.2": "",
+    "26.2": "minecraft:name_tag_distance"
+   }
+  },
+  "oxygen_bonus": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:generic.oxygen_bonus",
+    "1.21.2": "minecraft:oxygen_bonus"
+   }
+  },
+  "safe_fall_distance": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:generic.safe_fall_distance",
+    "1.21.2": "minecraft:safe_fall_distance"
+   }
+  },
+  "scale": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:generic.scale",
+    "1.21.2": "minecraft:scale"
+   }
+  },
+  "sneaking_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:player.sneaking_speed",
+    "1.21.2": "minecraft:sneaking_speed"
+   }
+  },
+  "spawn_reinforcements": {
+   "ids": {
+    "1.7.2": "zombie.spawnReinforcements",
+    "1.16": "minecraft:zombie.spawn_reinforcements",
+    "1.21.2": "minecraft:spawn_reinforcements"
+   }
+  },
+  "step_height": {
+   "ids": {
+    "1.7.2": "",
+    "1.20.5": "minecraft:generic.step_height",
+    "1.21.2": "minecraft:step_height"
+   }
+  },
+  "submerged_mining_speed": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:player.submerged_mining_speed",
+    "1.21.2": "minecraft:submerged_mining_speed"
+   }
+  },
+  "sweeping_damage_ratio": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:player.sweeping_damage_ratio",
+    "1.21.2": "minecraft:sweeping_damage_ratio"
+   }
+  },
+  "tempt_range": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.2": "minecraft:tempt_range"
+   }
+  },
+  "water_movement_efficiency": {
+   "ids": {
+    "1.7.2": "",
+    "1.21": "minecraft:generic.water_movement_efficiency",
+    "1.21.2": "minecraft:water_movement_efficiency"
+   }
+  },
+  "waypoint_receive_range": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.6": "minecraft:waypoint_receive_range"
+   }
+  },
+  "waypoint_transmit_range": {
+   "ids": {
+    "1.7.2": "",
+    "1.21.6": "minecraft:waypoint_transmit_range"
+   }
+  }
+ }
+}

mcdex/banner_patterns/__init__.py

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

mcdex/banner_patterns/_mc_banner_patterns.py

@@ -0,0 +1,86 @@
+"""
+MCBannerPatterns is the catalogue of the game's banner patterns: an enumeration
+with one member for every banner pattern of the data file that ships with
+mcdex, each the same banner pattern in every version, with the id each version
+knows it by: what a banner's pattern takes.
+"""
+#  Apache-2.0 license
+#  Copyright (c) 2026 Asger Jon Vistisen
+from __future__ import annotations
+
+from worktoy.keenum import Kee
+
+from ..base import BannerPatternId, MCThing
+
+
+class MCBannerPatterns(MCThing):
+  """
+  The catalogue of the game's banner patterns, each a member, found by its name
+  in capitals, in any case, or by its unique name:
+
+    squareBottomLeft = MCBannerPatterns.SQUARE_BOTTOM_LEFT
+    squareBottomLeft is MCBannerPatterns['square_bottom_left']  # True
+    squareBottomLeft['1.8']  # BannerPatternId('square_bottom_left', 'bl')
+    len(MCBannerPatterns)
+
+  Implementation
+  --------------
+
+  All of it is 'MCThing's, reading 'banner_patterns.json' beside this module.
+  mcdex's tools write the members, one for every name of that file.
+  """
+
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  #  NAMESPACE  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+  # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+  #  Class Variables
+  __data_file__ = 'banner_patterns.json'
+  __data_key__ = 'banner_patterns'
+  __id_class__ = BannerPatternId
+  __kind__ = 'banner pattern'
+
+  #  Members, one for every name of 'banner_patterns.json'
+  BASE = Kee[str]('base')
+  BORDER = Kee[str]('border')
+  BRICKS = Kee[str]('bricks')
+  CIRCLE = Kee[str]('circle')
+  CREEPER = Kee[str]('creeper')
+  CROSS = Kee[str]('cross')
+  CURLY_BORDER = Kee[str]('curly_border')
+  DIAGONAL_LEFT = Kee[str]('diagonal_left')
+  DIAGONAL_RIGHT = Kee[str]('diagonal_right')
+  DIAGONAL_UP_LEFT = Kee[str]('diagonal_up_left')
+  DIAGONAL_UP_RIGHT = Kee[str]('diagonal_up_right')
+  FLOW = Kee[str]('flow')
+  FLOWER = Kee[str]('flower')
+  GLOBE = Kee[str]('globe')
+  GRADIENT = Kee[str]('gradient')
+  GRADIENT_UP = Kee[str]('gradient_up')
+  GUSTER = Kee[str]('guster')
+  HALF_HORIZONTAL = Kee[str]('half_horizontal')
+  HALF_HORIZONTAL_BOTTOM = Kee[str]('half_horizontal_bottom')
+  HALF_VERTICAL = Kee[str]('half_vertical')
+  HALF_VERTICAL_RIGHT = Kee[str]('half_vertical_right')
+  MOJANG = Kee[str]('mojang')
+  PIGLIN = Kee[str]('piglin')
+  RHOMBUS = Kee[str]('rhombus')
+  SKULL = Kee[str]('skull')
+  SMALL_STRIPES = Kee[str]('small_stripes')
+  SQUARE_BOTTOM_LEFT = Kee[str]('square_bottom_left')
+  SQUARE_BOTTOM_RIGHT = Kee[str]('square_bottom_right')
+  SQUARE_TOP_LEFT = Kee[str]('square_top_left')
+  SQUARE_TOP_RIGHT = Kee[str]('square_top_right')
+  STRAIGHT_CROSS = Kee[str]('straight_cross')
+  STRIPE_BOTTOM = Kee[str]('stripe_bottom')
+  STRIPE_CENTER = Kee[str]('stripe_center')
+  STRIPE_DOWNLEFT = Kee[str]('stripe_downleft')
+  STRIPE_DOWNRIGHT = Kee[str]('stripe_downright')
+  STRIPE_LEFT = Kee[str]('stripe_left')
+  STRIPE_MIDDLE = Kee[str]('stripe_middle')
+  STRIPE_RIGHT = Kee[str]('stripe_right')
+  STRIPE_TOP = Kee[str]('stripe_top')
+  TRIANGLE_BOTTOM = Kee[str]('triangle_bottom')
+  TRIANGLE_TOP = Kee[str]('triangle_top')
+  TRIANGLES_BOTTOM = Kee[str]('triangles_bottom')
+  TRIANGLES_TOP = Kee[str]('triangles_top')