PRISM_by_GoodMC

## **This project is supported by GoodMC.org** PRISM is a Bukkit plugin that tracks changes to a Minecraft world. These changes can be looked up, rolled back, restored, etc. There are also various anti-griefing tools. PRISM is a more resource efficient, fast, highly functional, user-friendly alternative to CoreProtect. ***PRISM by GoodMC exists as a faster updated version of the original PRISM with more features:*** * [Fix for rollback not working for bedrock players](https://github.com/prism/prismrefracted/pull/64) * [Paste.gg fixes](https://github.com/prism/prismrefracted/pull/65) * [Inspector wand fix](https://github.com/prism/prismrefracted/pull/66) * [1.20 support](https://github.com/prism/prismrefracted/pull/59) * [Fix undo action type check](https://github.com/prism/prismrefracted/pull/63) * [Item rollback improvements](https://github.com/prism/prismrefracted/pull/41) * [Rewrite explode track](https://github.com/prism/prismrefracted/pull/31) * [Block action logging improvements](https://github.com/prism/prismrefracted/pull/30) * [Store rollback state into database](https://github.com/prism/prismrefracted/pull/27) (This also fixes serious PRISM issues such as item dupes on multiple rollbacks) * [Any more!](https://github.com/opencommunity-original/prismrefracted/commits/original-prism) ## **[Documentation](https://prism-bukkit.readthedocs.io/en/latest/)** **Features Overview** * Prism tracks tons of different player, entity, and world events. * Multiple tools and commands let you see exactly what happened. * Powerful rollback/restore engine with complex search criteria. * Several extra grief management features. * Fully configurable wand system, with multiple modes and per-player personalization so it works exactly how you want. * Rollback or restore events directly, or with a preview mode first. * Highly configurable event tracking, to work just the way you want it. * Safe command defaults (can be configured), very clean and easy to read chat messages. * Requires MySQL/MariaDB **Event Detail** * Includes block changes, container access, item inserts/remove/pickups/drops, entity deaths, shearing, vehicle events, and a LOT more. * Related events tracked to causing player like blocks falling, blocks detaching, trees growing, and much more. * Smart logging and rollback of important related data like sign text, sheep color, wolf owner, animal age, villager profession, etc * Tracks liquid flow and items that break because of it (lava/water-break can be tracked even when *-flow is off) * Tracks world edits (requires WorldEdit) * Fine-tuned config allows you to control tracking of every single event. * Powerful config/personalization system for all wands - set the mode, item, even allow users to personalize how their own wands work. * Inspector wand allows you to find history for single blocks/spaces. * The /near command finds recent events around you. * Lookup command is extremely powerful with our versatile parameters. * Lookup results group together, turning hundreds of duplicate records for a player into one, with a count. * Powerful parameters support exclusions, listing multiple, partial name filter, and more. * Action names also have short-names for easier typing and can be used to combine related actions. * Radius parameter supports world edit selections, basing off another online player, and more. * A wide range of flags allow you to change lookup behavior at command time * Very clean chat messages and paginated results to ease your burden, with clickable interface. **Rollbacks, Restore, Preview (R/R/P)** * Rollback and restore commands with powerful search criteria. * Rollback or restore directly, or preview changes for both modes first. * Apply/cancel previews, or let them auto-cancel after a minute. * Extremely safe default parameters make it harder for you to make mistakes, but can be overridden in-game when you absolutely need them, or can be disable entirely via config. * You can even rollback killed entities, items taken from containers, broken vehicles, and more. * Sign rollbacks will restore their text * Rollbacks of burn events also extinguish fires. * Rollbacks of TNT/creeper explosion events also remove the laggy item drops. * Heavily tested to ensure that rollbacks are smart - problem items like doors, beds, cactus, sugar cane, and others are always restored properly! No half-doors! * Rollbacks/restores can be alerted to nearby players, and to staff members (staff see actual rollback params). * Rollback systems moves any players or animals in the way to a safe position on rollback * Rollback/restore world edits (requires WorldEdit 7.0.1) * Advanced, optional flags give you ultimate control over the rollback/restore action at command-time. **Extra Features** * Alerts for staff when players find natural ores (configurable). * Alerts for staff when players use flint and steel, place lava. * Alerts for staff on configurable list of placed/broken blocks (like tnt). * Alerts for staff for suspected piston xray cheats. * Put out fires with the extinguish command * Drain all liquids or just water/lava * Profile wand shows you data about a block. * The /what command identifies items you hold. **API** * Prism API allows other plugins to query and record data. * Lookup API allows plugins to perform a lookup, and process the results. * Rollback/Restore API allows a plugin to activate a rollback/restore and process the results * Custom Event tracking: Plugins can define custom events that Prism can track for them. * Custom Event Applier: Plugins can define custom rollback/restore code for their own events!! **Credits** * viveleroi, created for his Darkhelmet Minecraft server * github contributors, former stewardship by addstarmc * Artwork by LegendarySoldier