PlaceholderAPI is optional. When installed, XMas Tree registers the onembxmastree expansion for holograms, scoreboards, menus, and leaderboard displays.
See placeholders.md for the complete placeholder table.
CMI is not required, but it is useful for milestone rewards, holograms, toasts, and economy commands.
Milestone reward commands run from console and can include CMI commands:
reward-commands:
- cmi kit christmas {player}
- cmi money give {player} 250
- cmi toast {player} -t:task -icon:EMERALD -text:"{display_name} complete!"CMI holograms can display PlaceholderAPI values:
&aX-Mas Event: &f%onembxmastree_event.active_text%
&aEnds in: &f%onembxmastree_event.ends_in%
&aTrees planted: &f%onembxmastree_trees.total%
Use LuckPerms or another permissions plugin to assign granular permissions:
- player groups usually receive the default
truepermissions - staff groups can receive command-specific admin permissions
- full admins can receive
onembxmastree.admin
The modern namespace is onembxmastree.*.
The plugin exposes totals through PlaceholderAPI, which can be used by leaderboard or scoreboard plugins that support PlaceholderAPI:
%onembxmastree_trees.total%
%onembxmastree_trees.owners%
%onembxmastree_player.trees%
%onembxmastree_community.gifts_opened%
XMas Tree can load legacy tree records across renamed worlds with migration.world-aliases. If a world manager changes world names between event years, use /xmastree data validate and /xmastree data migrate-world before opening the event.
This fork targets Paper 26.2 and Java 25. Particle names, material names, and plugin metadata are documented for that environment.