Skip to content

About

This open source plugin is intended to allow players to add lore to their items in Minecraft.

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

PlayerLore

Two /pl add commands on an iron sword, and the sword's tooltip showing both lines of lore

Real in-game output from PlayerLore 2.1.2 on a local throwaway Paper 1.21.11 test server: the commands were typed by a scripted bot client, and the chat it received is drawn as Minecraft-style chat (typed commands appear in the input bars; grey lines say what happened between commands).

This open source plugin is intended to allow players to add lore to their items in Minecraft.

Supported Minecraft Versions

This plugin is supported on the Minecraft versions listed in minecraft-versions.json: currently 1.19.4, 1.21.11, 26.2 and 26.3 (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and every build checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.

Download

Works Well With

PlayerLore is part of the medieval roleplay set of Dan's Plugins. These are companion plugins that suit the same kind of server and run side by side; PlayerLore does not depend on or call into any of them.

  • Medieval Roleplay Engine (SpigotMC, /dpm get medievalroleplayengine): character cards, local, global, whisper and yell chat, emotes, dice and messenger birds.
  • Medieval Factions (SpigotMC, /dpm get medievalfactions): nation-like factions with land claims, diplomacy and laws. Its add-ons are listed in its Expansions section.
  • Mailboxes (SpigotMC, /dpm get mailboxes): persistent mail between players, with item attachments.
  • Medieval Economy (SpigotMC, /dpm get medievaleconomy): a coinpurse and a physical currency item.
  • Medieval Cookery (no SpigotMC page, no stable release yet): cooking recipes for custom foods, defined by the server owner.
  • Conquest Recipes (SpigotMC, /dpm get conquestrecipes): recipes for historical weapons, armour and shields named to match the Conquest resource pack.

Every plugin above is listed on dansplugins.com. PlayerLore is listed at dansplugins.com/resources/player-lore and can be installed in game with Dan's Plugin Manager: /dpm get playerlore.

Usage reporting

PlayerLore reports its usage by default: when the plugin is enabled, and each time one of its commands is used, it sends its name, its version and the base command typed (pl or playerlore, never the subcommand) to https://trace.danielstephenson.dev, so it is known which plugins are actually in use. Nothing about players, worlds or IP addresses is sent, and neither is anything typed after a command.

Each event also carries a random server ID (the server-id line in plugins/trace/config.yml) so servers can be counted rather than events. It identifies no person, account or IP address; delete the line to get a new one.

To turn it off:

  • for this plugin only: set usage-reporting.enabled: false in plugins/PlayerLore/config.yml;
  • for every plugin on the server that reports to trace: set enabled: false in plugins/trace/config.yml (created on the first start);
  • for the whole server process: set the environment variable TRACE_USAGE_REPORTING=off or DO_NOT_TRACK=1.

Details: https://danielstephenson.dev/usage-reporting

About

This open source plugin is intended to allow players to add lore to their items in Minecraft.

Topics

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Contributors

Languages