GoldPiglin
Navigating the Nether in Minecraft is always a tense affair, especially when you forget to don a piece of gold armor. Piglins, those gold-obsessed inhabitants, will attack on sight unless you appease them with something shiny. But what if your favorite armor set already has gold trim? The GoldPiglin add-on solves that exact problem, making piglins treat any armor with gold patterns as if it were pure gold. It is a lightweight, server-side plugin that enhances vanilla behavior without requiring players to install anything on their clients.
What is GoldPiglin?
GoldPiglin is a specialized add-on for Minecraft servers running Spigot or Paper. Its core purpose is simple: when you wear armor that includes gold patterns—like the popular gold-trimmed netherite—piglins will ignore you, exactly as they would if you were wearing a full gold piece. This small change makes exploration and building in the Nether far more convenient, especially for players who prefer the durability of netherite but still want the safety of gold’s pacifying effect.
The project is still under active development, so some features may be missing or refined over time. However, the current version already emulates vanilla behavior and adds enhanced behaviors such as eye tracking, making piglin interactions feel more natural. Importantly, GoldPiglin is not planned for a ModLoader port, as similar functionality already exists in that ecosystem. It is purpose-built for the Spigot/Paper server environment.
Key Features
- Gold-Pattern Armor Recognition: Any armor piece with a gold trim pattern (found in vanilla Minecraft 1.20+) will pacify piglins, just like wearing a gold armor item.
- Vanilla Behavior Emulation: The add-on closely mimics how piglins react to gold armor in the base game, ensuring a seamless experience.
- Enhanced Eye Tracking: Piglins will visually track the player, adding a layer of immersion even when they are neutral.
- Flexible Adapter System: Choose between Spigot, Paper, NBTAPI, or Rtag adapters to match your server setup and performance needs.
- Configurable Hatred Mechanics: Fine-tune how long piglins remain aggressive after provocation, and whether only piglins in the player’s line of sight react.
Supported Versions and Adapters
GoldPiglin is designed for Minecraft 1.20.1 and runs on both Spigot and Paper servers. The add-on uses an adapter system to interact with the server’s core, and you can select the one that best fits your environment. The Spigot adapter (NMS mode) is compatible with version 1.20.1-26.2, but if Minecraft updates, you may need to wait for a new GoldPiglin release. The Paper adapter (NMS mode) is more resilient to minor updates and often works without waiting. Additionally, you can use the NBTAPI or RTag adapters for a more abstracted approach that doesn’t rely on direct NMS access. All adapters behave identically in terms of gameplay, so the choice is purely technical.
How to Install GoldPiglin
Installing GoldPiglin is straightforward. First, ensure your server runs Java 17 or higher (Java 21 is recommended). Then, download GoldPiglin from its official repository and place the JAR file into your server’s plugins folder. If you are using the optional NBTAPI or RTag adapters, you will also need to download those dependencies (NBT-API v2.13.2 or RTag v1.5.10) and add them to the same folder. Restart your server, and the plugin will generate a default configuration file.
For server administrators who prefer a more streamlined setup, the foxygame.net launcher includes GoldPiglin in its curated add-on catalog. With one click, the launcher handles the correct version matching and dependency installation, saving you from manual file management. This is especially handy if you run multiple servers and want to keep GoldPiglin updated automatically across all of them.
Configuration and Customization
Once installed, you can tweak GoldPiglin’s behavior via the config.yml file. The main options include:
- adapter: Choose between Spigot, Paper, NBTAPI, or Rtag. The NBTAPI adapter is often recommended for its balance of performance and compatibility.
- debug: Set to true for detailed logging if you encounter issues.
- update-message: When enabled, operators will receive a notification if a new version of GoldPiglin is available.
- hatred: Control how long piglins stay angry after being provoked (expiration-time) and how often the scanner checks (expiration-scanner-time).
- near: Enable area-wide hatred for a more vanilla-like experience, though it may increase calculation time. You can define the radius in X, Y, Z blocks.
- can-see: Restrict hatred to piglins within the player’s line of sight. You can also toggle native Spigot’s canSee API or use GoldPiglin’s own line-of-sight calculation, and even reverse the calculation to check from the entity’s perspective.
These settings let you fine-tune performance and behavior to match your server’s style. For most small servers, the default values work perfectly.
Commands and Permissions
GoldPiglin adds two simple commands, both accessible via /goldpiglin or the alias /gpiglin:
/goldpiglin reload– Reloads the configuration without restarting the server./goldpiglin version– Displays the current add-on version.
Permissions are node-based and default to OP (server operators):
goldpiglin.command.reloadgoldpiglin.command.versiongoldpiglin.update_message– Controls who sees update notifications.
These permissions allow you to delegate management to trusted staff without giving full operator status.
Why Choose GoldPiglin?
GoldPiglin fills a small but impactful gap in vanilla Minecraft logic. With the introduction of armor trims, many players wear gold-patterned gear that logically should appease piglins, yet the base game ignores it. This add-on corrects that oversight, making the Nether less frustrating while preserving the challenge. It is lightweight, highly configurable, and respects the vanilla feel. The adapter system ensures broad compatibility, and the active development means more polished features are on the way.
Whether you run a survival server, a minigame hub, or a private world for friends, GoldPiglin for Minecraft is a subtle quality-of-life improvement that your players will appreciate. Download GoldPiglin today and give your gold-trimmed armor the respect it deserves in the Nether.