Player Attunement

🔑 Player Attunement (PAM)

Bring the thrill of earned progression back to Minecraft!

Ever feel like a fresh Minecraft world moves a little too fast? You spawn in, strip-mine for twenty minutes, rush into the Nether in iron armor, beat the Ender Dragon, and suddenly… the sense of adventure fades because you skipped straight to the endgame.

PAM brings back the journey. Inspired by classic MMO raid and dungeon attunements, PAM turns dimensions, endgame equipment, and high-tier utility blocks into earned milestones. Instead of sequence-breaking straight to flight and endgame gear, you’ll conquer the game step-by-step—earning your keys to new worlds by completing advancements, slaying bosses, and mastering your gear!

• Mod ID: pam
• Author: lindvall.io
• Target: Minecraft 26.2 (NeoForge)
• License: LGPL-3.0

---

🌟 Why Play With PAM?

• 🏆 Meaningful Milestones: Make dimension entry and high-tier equipment feel like true achievements rather than quick speedrun stops.
• 🧭 Restored Mid-Game: Gives players a reason to explore, farm gear, complete achievements, and tackle boss fights before unlocking game-changing power.
• 🎨 Pick Your Pace: Built-in progression presets let you choose between a light vanilla touch, a full RPG overhaul, or absolute sandbox freedom.
• 🖥️ Seamless Everywhere: Singleplayer players get a gorgeous 3-box splash-art setup screen on world creation, while dedicated servers enjoy zero-fuss headless configuration.
• 🛠️ Modpack Author Friendly: Everything is data-driven! Easily gate custom modded dimensions, custom weapons, or unique recipes using simple JSON datapacks.

---

⚙️ Progression Difficulty Presets

Choose the pacing that matches your playstyle right when you launch a world:

Preset	Vibe	What's Gated?
🟢 Sandbox (none)	Classic Minecraft	Nothing! PAM stays out of the way so you can play purely unhindered.
🔵 Vanilla+ (vanilla_plus)	Natural Pacing	Light-touch gating. Nether entry, End entry, and Elytra flight are locked behind their natural vanilla milestones ("Covered in Diamonds", Blaze Rods + Netherite gear, and slaying the Ender Dragon).
🔴 RPG Progression (attunement_progression)	Full MMO Gating	The ultimate progression journey. Everything in Vanilla+, plus Diamond/Netherite gear (Suit Up + level 20 / Fortress + Ancient Debris), Shulker Boxes & Ender Chests (levitation), Totems of Undying (Hero of the Village), and Beacons locked behind boss kills and skill checks!

Note: Your choice is sticky per world! Once set, it won't change unless an operator runs /pam preset set.

---

💻 Admin & Operator Commands

Easily manage player progression on servers or singleplayer worlds (requires Op Level 2 / GameMaster permissions):

/pam grant <player> <attunement_id>         Grant a specific attunement key
/pam revoke <player> <attunement_id>        Revoke a specific attunement key
/pam list [player]                         List a player's unlocked attunements
/pam clear <player>                         Wipe all of a player's attunements
/pam preset get                            Show the world's active preset
/pam preset set <none|vanilla_plus|attunement_progression>   Change the active preset

---

📦 For Modpack Authors: 100% Datapack Driven

Presets live in data/<namespace>/presets/*.json as clean, readable data structures:

{
  "id": "pam:my_preset",
  "name": "My Custom Pacing",
  "attunements": [
    {
      "id": "pam:nether_entry",
      "requirements": {
        "advancements": ["minecraft:story/shiny_gear"],
        "min_player_level": 10
      },
      "locks": { "dimensions": ["minecraft:the_nether"] },
      "denial_message": "pam.denied.nether_entry"
    }
  ]
}

• Requirements: Categories combine with AND across categories, while any single entry satisfies items_crafted or entities_killed (listed advancements must all be completed).
• Lock Types: Lock dimensions, items (armor/tools/right-click/totems), blocks (beacons, ender chests, shulker boxes), and entities (exposed for API consumers).

Add or override presets from any datapack — no code required! Higher-priority packs win, just like standard vanilla data assets.

---

🔌 Developer API

Building a custom script or integration? PAM exposes a clean Java API under com.zenil.pam.api:

• AttunementApi: Programmatically query, grant, revoke, or evaluate attunements.
• AttunementCheckEvent: Force-allow or force-deny lock checks dynamically from another mod, KubeJS, or CraftTweaker.
• AttunementUnlockEvent: React instantly when a player earns a new milestone key.

---

⚙️ Server Configuration

On dedicated servers, PAM generates config/pam-server.toml on first startup for simple headless setup:

[general]
    # The progression preset applied to any world on this server that has not chosen one yet.
    # One of: none, vanilla_plus, attunement_progression
    default_preset = "vanilla_plus"

---

⚠️ Known Limitations

• HUD Tracker: No full HUD progression tracker UI yet — denial notices sync over the network, but a richer in-game progress UI is planned for a future release.
• Melee Attacks: Melee attacking with a locked weapon isn't intercepted (equip, right-click use, and block-breaking are).
• Preset Switching: /pam preset set doesn't retroactively re-check online players against newly-active locks — players pick up new attunements on their next relevant trigger (advancement, craft, kill, level-up).
• Entity Locks: Entity-interaction locks are exposed in the schema/API but have no built-in handler; wire your own via AttunementApi.evaluate(..., LockType.ENTITY, ...).

---

📥 Installation

Drop pam-mc26.2_1.0.0.jar into your mods folder alongside NeoForge. No extra dependencies required!

---

📋 Requirements & Specs

• Minecraft: 26.2
• Mod Loader: NeoForge 26.2.0.41-beta or higher
• Mod ID: pam
• Author: lindvall.io
• License: LGPL-3.0
• Environment: Works in both Singleplayer and Dedicated Servers (Requires installation on both client and server for networking and denial sync).