articdive / articdata

Collection of data extracted from Minecraft.

ArticData

This is a data extractor and generator for Minecraft.

It works in the JVM 16 (or higher) environment it takes advantage of Gradle and is written in Java. The generators for this data are located here.

Table of Contents

• Install
• Usage
• Supported Data
  • Attributes
  • Biomes
  • Blocks
  • Block Entities
  • Block Properties
  • Commands
  • Custom Statistics
  • Dimension Types
  • Dye Colors
  • Enchantments
  • Entities
  • Entity Data Serializers
  • Fluids
  • Fluid Properties
  • Game Events
  • Map Colors
  • Items
  • Potion Effects
  • Packets
  • Particles
  • Potions
  • Recipes
  • Sounds
  • Sound Sources
  • Villager Professions
  • Villager Types
• Maintainers
• Contributing
• License

Install

Maven and Gradle

To add ArticData (not the generators!) to your project using Maven or Gradle:

Adding to a Maven Project:

<dependencies>
    <dependency>
        <groupId>de.articdive</groupId>
        <artifactId>articdata</artifactId>
        <version>1.20.4-cb27856f</version>
    </dependency>
</dependencies>

Adding to a Gradle Project (Kotlin DSL)

repositories {
    mavenCentral()
}
dependencies {
    implementation("de.articdive:articdata:1.20.4-cb27856f")
}

Usage

The repository artifacts include the data located here.

They include JSON files full of useful data to do with Minecraft.

Supported Data

We emit data in two ways:

• One JSON Object with namespaced identifiers as keys for json objects. Example
• One JSON Array with many json objects. Example

If you require any data, open a GitHub Issue and specify the data you need.

WARNING: There is no guarantee that the format of the data will stay the same.

Attributes

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Translation Key	✔️
Default Value	✔️
Client Synchronization	✔️
Attribute Range	✔️

Biomes

Data Type	Supported?
Namespace ID	✔️
Carvers, Features & Creatures	✔️
Mob Spawning	✔️
Temperature	✔️
Percipitation	✔️

Blocks

Data Type	Supported?	Description
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Translation Key	✔️
Loot Table Key	✔️
Block States	✔️
BlockState Properties	✔️
Block Entities	✔️
Hardness	✔️
Explosion Resistance	✔️
Friction	✔️
Speed & Jump Factor	✔️
Default Block State	✔️
Corresponding Item	✔️
Corresponding Map Color	✔️
Solid, Liquid, Blocking etc.	✔️
Piston Push Reaction	✔️
Gravity	✔️
Respawn Eligiblity	✔️	Moved to BlockState in 1.20.
Tool Require For Drops	✔️
Large Collision Shape	✔️
Collision Shape Full Block	✔️
Occlusion	✔️
Hitbox	✔️
Collision Hitbox	✔️
Interaction Hitbox	✔️
Occlusion Hitbox	✔️
Visual Hitbox	✔️
Dynamic Shape	✔️
Solid Render	✔️
Light Emission	✔️
Light Block	✔️
Propagates Skylight Down	✔️
Shape for Light Occlusion	✔️
Opacity	✔️
Conditional Opacity	✔️
Render Shape	✔️
Offset	❌	Moved to BlockState in 1.19.
Vertical Offset	✔️
Horizontal Offset	✔️
Sound Information	✔️
Pick Block Information	❌	Not possible since 1.20.3.

Block Entities

Data Type	Supported?
Namespace ID	✔️
Mojang Name	✔️
Block IDs	✔️

Block Properties

Data Type	Supported?
Mojang Name	✔️
Key	✔️
Possible Values	✔️

Commands

Data Type	Supported?	Description
Entire Command Tree	✔️	See https://wiki.vg/Command_Data

Custom Statistics

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️

Dimension Types

Data Type	Supported?
Namespace ID	✔️
Bed Works	✔️
Coordinate Scale	✔️
Ceiling Height	✔️
Fixed Time	✔️
Raids	✔️
Sky Light	✔️
Piglin Safe	✔️
Logical Height	✔️
Natural	✔️
Ultra Warm	✔️
Respawn Anchor Works	✔️
MinY	✔️
Height (maxY)	✔️

Dye Colors

Data Type	Supported?
Protocol ID	✔️
Mojang Name	✔️
Color (Corresponding Map Color)	✔️
Firework Color (Decimal)	✔️
Text Color (Decimal)	✔️
TextureDiffuseColor (Decimal)	✔️
TextureDiffuseColorBGR (Decimal)	✔️
TextureDiffuseColors	✔️

Enchantments

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Translation Key	✔️
Max Level	✔️
Rarity	✔️
Curse	✔️
Discoverable	✔️
Tradeable	✔️
Treasure Only	✔️
Category	✔️
Incompatible Enchantments	✔️

Entities

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Translation Key	✔️
Loot Table Key	✔️
Entity Data Packet Info	✔️
Packet Type	✔️
Fire Immunity	✔️
Height	✔️
Width	✔️
Client Tracking Range	✔️

Entity Data Serializers

Data Type	Supported?
Protocol ID	✔️
Mojang Name	✔️

Fluids

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Corresponding Bucket Item	✔️

Fluid Properties

Data Type	Supported?

Game Events

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Notification Radius	✔️

Map Colors

Data Type	Supported?
Protocol ID	✔️
Mojang Name	✔️
Color (Decimal)	✔️

Items

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Translation Key	✔️
Depletes	✔️
Max Stack Size	✔️
Max Damage (Durability)	✔️
Edible	✔️
Fire Resistant	✔️
Corresponding Block	✔️
Eating & Drinking Sound	✔️
Food Properties	✔️
Armor Properties	✔️
Spawn Egg Properties	✔️
Tool Properties	✔️
Bucket Properties	✔️
Dye Properties	✔️

Potion Effects

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Color (Decimal)	✔️
Instanteneous	✔️
Attribute Modifiers	✔️

Packets

Data Type	Supported?
Packet ID	✔️
Packet Classname	✔️
Packet Direction	✔️
Connection State	✔️

Particles

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️

Potions

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Potion Effects	✔️

Recipes

Data Type	Supported?
Mojang ID	✔️
Recipe Type	✔️
Layout	✔️
Recipe	✔️
Result	✔️

Sounds

Data Type	Supported?	Description
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️	Goat Horn Sound Variants are not named by Mojang.
Translation Key	✔️

Sound Sources

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Type	✔️

Villager Professions

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️
Work Sound	✔️

Villager Types

Data Type	Supported?
Protocol ID	✔️
Namespace ID	✔️
Mojang Name	✔️

Maintainers

@Articdive

Contributing

See the contributing file!

License

Data is licensed under the Minecraft EULA. The rest (Format, Generators, etc.) is licensed under the MIT License © Articdive.

articdata's Issues

the superclasses were not considered in the metadata array

Example:
Sheep Entity is missing Health Metadata inherited from packetType LIVING

PotionEffects are missing modifiers

Example

"speed": {
    "id": 1,
    "color": 1234,
    "instantaneous": false,
    "translationKey": "peter123"
    "mojangName": "SPEED",
    "modifiers": [
      {
        "attribute": "GENERIC_MOVEMENT_SPEED",
        "uuid": "91aeaa56-376b-4498-935b-2f7f68070635",
        "value": 0.20000000298023224,
        "operation": "MULTIPLY_TOTAL"
      }
    ]
  }

collect data for all minecraft release version

Would you consider to collect data for all release version ?

minecraft version : https://launchermeta.mojang.com/mc/game/version_manifest.json

Potions are missing their assigned potion_effect

Example:

  "awkward": {
    "id": 4,
    "mojangName": "AWKWARD",
    "effects": []
  },
  "night_vision": {
    "id": 5,
    "mojangName": "NIGHT_VISION",
    "effects": [
      {
        "mojangName": "NIGHT_VISION",
        "duration": 3600,
        "amplifier": 0,
        "ambient": false,
        "show_particles": true,
        "show_icon": true
      }
    ]
  },
  "turtle_master": {
    "id": 20,
    "mojangName": "TURTLE_MASTER",
    "effects": [
      {
        "mojangName": "SLOWNESS",
        "duration": 400,
        "amplifier": 3,
        "ambient": false,
        "show_particles": true,
        "show_icon": true
      },
      {
        "mojangName": "RESISTANCE",
        "duration": 400,
        "amplifier": 2,
        "ambient": false,
        "show_particles": true,
        "show_icon": true
      }
    ]
  }