HawkStudiosDocs
minecraftPluginsPackmaster

Packmaster

What is Packmaster?

PackMaster is a Minecraft plugin that simplifies resource pack management by allowing server administrators to host and distribute resource packs directly through the server. It eliminates the need for external hosting services and automatically manages resource pack distribution to players upon joining the server.

Installation

  1. Download the latest version of PackMaster from any of the following sources:
  1. Install PacketEvents

  2. Place the downloaded files in the plugins folder of your Minecraft server.

  3. Start or restart your server. And enjoy!

Configuration

server:
  ip: "127.0.0.1"
  pack-port: 8163
 
resourcepack:
  output-folder: "output"
  auto-send: true
  kick-on-decline: true

Commands

  • /reloadpack - Reload the resource pack
  • /assignpack - Assigns a resource pack to a player

Permissions

  • packmaster.admin - Admin permission, default is op

Resourcepack tutorial

  1. Create a resourcepack folder inside the “plugins\PackMaster\resourcepacks” folder.

  2. inside the resourcepack folder, create a “pack.mcmeta” file and add the following:

{
  "pack_format": 18
}
  1. inside the resourcepack folder, create a “assets” folder. here’s the structure:
resourcepack
  - assets
    - minecraft
      - textures
        - item
      - models
        - item
  1. create the “paper.json” file inside the “models/item” folder, add the following:
{
  "parent": "item/generated",
  "textures": {
    "layer0": "minecraft:item/my_custom_texture"
  }
}
  1. Place your custom texture (my_custom_texture.png) in the textures/item folder.

  2. The final structure should look like this:

resourcepack
  - pack.mcmeta
  - assets
    - minecraft
      - textures
        - item
          - my_custom_texture.png
      - models
        - item
          - paper.json
  1. Restart the server or use /reloadpack and /assignpack commands to apply changes.

Note: The pack_format value of 18 corresponds to Minecraft 1.21.3. Here’s a reference for other versions:

  • 1.20.x: pack_format 15
  • 1.19.x: pack_format 12-13
  • 1.18.x: pack_format 8-9
  • 1.17.x: pack_format 7-8

Custom Item with modelid texture Creation

To create a custom item, you need three components:

  1. Model ID (CustomModelData)
  2. Material (Minecraft item to override)
  3. Texture and model files

Here’s how to set it up:

  1. Choose a Material (e.g., paper, stick, diamond_sword)
  2. Pick a unique CustomModelData number (e.g., 1001)
  3. Update your material.json to include the CustomModelData:
{
    "parent": "item/generated",
    "textures": {
        "layer0": "minecraft:item/my_custom_texture"
    },
    "overrides": [
        {
            "predicate": {
                "custom_model_data": 1001
            },
            "model": "minecraft:item/my_custom_texture"
        }
    ]
}