https://github.com/bonka-software/placeholderitemmeta
A minecraft plugin that allows you to use (per player) placeholders in item names and lore.
https://github.com/bonka-software/placeholderitemmeta
itemstack mincraft-plugin minecraft packet-based paper spigot
Last synced: about 1 month ago
JSON representation
A minecraft plugin that allows you to use (per player) placeholders in item names and lore.
- Host: GitHub
- URL: https://github.com/bonka-software/placeholderitemmeta
- Owner: Bonka-Software
- License: apache-2.0
- Created: 2025-04-06T14:01:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-07T14:23:04.000Z (about 1 year ago)
- Last Synced: 2025-04-10T07:42:28.356Z (about 1 year ago)
- Topics: itemstack, mincraft-plugin, minecraft, packet-based, paper, spigot
- Language: Java
- Homepage: https://bonka.gg/
- Size: 30.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Placeholder Item Meta
Made for minecraft version `1.21.4`
[Available on Spigot](https://www.spigotmc.org/resources/placeholder-item-meta.123852/)
A minecraft plugin that allows you to use (per player) placeholders in item names and lore.
PIM uses protocolLib to intercept all outgoing item packets and replace any placeholders (e.g; %player_name%) in the name or lore of the item with PlaceholderAPI's data.
It's a very simple but effective plugin that also features some customizability to fit your specific needs.
Is there a feature missing, or are you running into a bug? Please consider opening an [issue](https://github.com/Bonka-Software/PlaceholderItemMeta/issues)!
---
#### Version 1.0.0
This version of PIM contains:
- Packet based placeholder rendering in item name and lore using [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) and [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/)
- Easy to use config, allowing you to whitelist certain data containers and block the use of placeholders when a player renames an item in an anvil.
---
## Dependencies
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
- [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/)
---
## Developers
This plugin is currently a bit too simple for an API. Please consider opening an issue if you do need to access certain parts of the plugin, I'll be happy to help!
You are also free to fork this project for your own use or contribute to the project, I don't have strict guidelines, but please try to adept a bit to the current code style, this will keep the project easy to read :)
Curious about how I change the itemstack packets? It mainly happens [here](https://github.com/Bonka-Software/PlaceholderItemMeta/blob/main/src/main/java/gg/bonka/placeholderItemMeta/items/listener/ItemPacketListener.java), this is the best place to start exploring the codebase!