PlotPlugin - Update Changelog

Version 0.4 - Advanced Plot Management (April 15, 2025)

New Features

• Vault Economy Integration
  • Replaced emeralds with Vault's economy system for plot expansion and upgrades.
  • Configure the cost of expanding plots (
    Code (Text):

    expand-cost
    ) and upgrading plot levels (
    Code (Text):

    upgrade-cost
    ) in
    Code (Text):

    config.yml
    .
  • Default: 1000 for expansion, 5000/10000 for upgrades to levels 2/3.
• Plot Invitation System
  • Added
    Code (Text):

    /plot invite <player>
    to invite players to your plot temporarily.
  • Invitations expire after a configurable time (default: 60 seconds).
  • Invited players can use
    Code (Text):

    /plot accept
    to join the plot's allowed list.
• Plot Flags
  • Owners can now customize plot behavior with
    Code (Text):

    /plot flag <flag> <true/false>
    .
  • Available flags:
    • Code (Text):

      pvp
      : Enable/disable PvP on the plot (default: false).
    • Code (Text):

      mobs
      : Allow/disallow attacking mobs by non-members (default: false).
    • Code (Text):

      pickup
      : Allow/disallow item pickup by non-members (default: false).
• Plot Levels and Upgrades
  • Plots now have levels (1-3) that determine their maximum size.
    • Level 1: 64x64 (default).
    • Level 2: 96x96 (upgrade cost: 5000).
    • Level 3: 128x128 (upgrade cost: 10000).
  • Use
    Code (Text):

    /plot upgrade
    to level up your plot, increasing its maximum expandable size.
• Automatic Inactive Plot Cleanup
  • Automatically removes plots of players who haven't logged in for a configurable time (default: 30 days).
  • Enable/disable in
    Code (Text):

    config.yml
    (
    Code (Text):

    auto-clean-enabled
    ) and set the inactivity threshold (
    Code (Text):

    auto-clean-days
    ).
  • Logs removed plots to the console for transparency.

️ Improvements

• Enhanced Plot List
  • Code (Text):

    /plot list
    now displays the level of each plot alongside its coordinates and world.
• Better Database Schema
  • Added columns to store plot levels, flags, and last login timestamps for the cleanup feature.
  • Added a new table (
    Code (Text):

    plot_invitations
    ) to manage temporary invitations.

Updated Commands

• Code (Text):

  /plot invite <player>
  : Invite a player to your plot.
• Code (Text):

  /plot accept
  : Accept a pending plot invitation.
• Code (Text):

  /plot flag <flag> <true/false>
  : Set plot-specific flags (pvp, mobs, pickup).
• Code (Text):

  /plot upgrade
  : Upgrade your plot's level to increase its maximum size.

Configuration Example

How to Update

1. Back up your existing
   Code (Text):

   plots.db
   and
   Code (Text):

   config.yml
   .
2. Replace the old PlotPlugin JAR with the new version in your
   Code (Text):

   plugins
   folder.
3. Restart your server to update the database schema and
   Code (Text):

   config.yml
   .
4. Review and customize the updated
   Code (Text):

   config.yml
   as needed.

Notes

• Important: This update modifies the database schema. Make sure to back up your
  Code (Text):

  plots.db
  before updating.
• Requires Vault and an economy plugin (e.g., EssentialsX) to function.
• If you encounter any issues or have feature requests, please share them in the discussion section or on Discord!

• Plot Creation with Plot Blocks
  • Craft a special "Plot Block" (8 diamonds surrounding 1 emerald) to claim a plot.
  • Right-click with the Plot Block to create a fixed-size plot (default: 64x64 blocks).
  • Admins can use /plot give (requires plot.give permission, default: op) to obtain Plot Blocks.
• Plot Management Commands
  • /plot create: Informs players to use a Plot Block to create a plot.
  • /plot delete: Deletes the plot you're standing on (owner only).
  • /plot add <player>: Adds a player to the plot's allowed list (owner only).
  • /plot remove <player>: Removes a player from the allowed list (owner only).
  • /plot list: Lists all your plots with their coordinates and world.
  • /plot show: Displays the boundaries of the plot you're on using particle effects (Villager Happy particles).
  • /plot expand: Expands your plot for a cost in emeralds (default: 10 emeralds, expands by 16 blocks in each direction).
  • /plot tp <number>: Teleports you to the center of a selected plot (number from /plot list).
• Plot Protection
  • Prevents unauthorized players from:
    • Breaking or placing blocks.
    • Interacting with chests, doors, or other blocks.
    • Attacking mobs or players (PvP protection).
    • Picking up items.
    • Using vehicles (e.g., minecarts, boats).
    • Interacting with item frames.
  • PvP is only allowed if both players are on the plot's allowed list (owner or added via /plot add).
• SQLite Database Storage
  • Plots are stored in a lightweight SQLite database (plots.db) for better performance and scalability.
  • No clutter in config.yml – all plot data is managed in the database.
• Customization with config.yml
  • Configure settings like:
    • max-plots-per-player (default: 3).
    • spawn-protection-radius (default: 100 blocks).
    • default-plot-size (default: 64 blocks).
    • max-plot-size (default: 128 blocks).
    • expand-size-increment (default: 16 blocks).
    • expand-cost-emeralds (default: 10).
  • Customize all messages with color code support (&).
• Safety Features
  • Spawn Protection: Plots cannot be created within a configurable radius of the world spawn (default: 100 blocks).
  • Plot Overlap Protection: Prevents plots from overlapping when created or expanded.
  • Maximum Plot Size: Limits plot expansion to a configurable maximum size (default: 128x128 blocks).
• Dynamic Update Checker
  • Automatically checks for updates on SpigotMC using their API.
  • Admins with plot.admin permission (default: op) receive update notifications on join.
  • The server console displays update notifications on startup.
  • Includes a direct link to the plugin page: SpigotMC - MyPlots.

1. Place the PlotPlugin JAR in your plugins folder.
2. Start your server to generate the config.yml and plots.db.
3. Customize the config.yml to your liking.
4. Reload or restart your server to apply changes.

• Requires Minecraft 1.21 (API version 1.21).
• The plugin uses SQLite, so no external database setup is needed.
• Internet access is required for the update checker to fetch the latest version from SpigotMC.
• If you encounter any bugs or have feature suggestions, please let me know in the discussion section or on Discord!

• Customizable Configuration
  Added a config.yml file for easy customization:
  • Adjust settings like max-plots-per-player, spawn-protection-radius, default-plot-size, expand-size-increment, and expand-cost-emeralds.
  • Customize all in-game messages with support for color codes (&). Personalize the prefix, error messages, and more to fit your server's style.
• Plot Expansion with Emeralds
  Players can now expand their plots using the /plot expand command:
  • Expands the plot by a configurable amount (default: 16 blocks in each direction).
  • Costs a configurable number of emeralds (default: 10).
  • Players must have enough emeralds in their inventory to expand.
• Plot Block Creation
  • Added a new "Plot Block" system for creating plots:
    • Craft a Plot Block using 8 diamonds and 1 emerald (shaped recipe: diamonds surrounding an emerald).
    • Alternatively, use /plot give (requires plot.give permission, default: op) to obtain a Plot Block.
    • Right-click with the Plot Block to create a plot centered at the clicked location.
  • Removed the old /plot setpos1 and /plot setpos2 commands in favor of the Plot Block system.
• Spawn Protection
  • Plots cannot be created too close to the world spawn (configurable radius, default: 100 blocks).
  • Prevents cluttering around the spawn area and ensures a balanced gameplay experience.
• Enhanced Plot Protection
  Expanded protection to cover more interactions:
  • Prevent unauthorized players from:
    • Picking up items on the plot.
    • Using vehicles (e.g., minecarts, boats).
    • Interacting with item frames.
  • Existing protections (block breaking/placing, chest access, mob attacks) remain in place.
• Fixed Plot Size
  • Plots are now created with a fixed size (default: 64x64 blocks), configurable in config.yml.
  • Ensures consistency and prevents overly large plots from being created accidentally.

• SQLite Database
  • Moved plot storage from config.yml to a lightweight SQLite database (plots.db).
  • Improves performance and keeps your server files clean.
• Better Plot Visualization
  • Plot boundaries are now visualized using particle effects (Villager Happy particles) when created or shown with /plot show.
  • Makes it easier for players to see their plot limits.
• Plot Listing
  Added /plot list command to display all plots owned by the player, including their coordinates and world.

• Fixed a method clash between getConfig() in PlotPlugin and JavaPlugin by renaming to getCustomConfig(). This resolves compilation issues.

• /plot create: Now informs players to use a Plot Block to create a plot.
• /plot expand: New command to expand your plot for emeralds.
• /plot give: Gives a Plot Block (permission: plot.give).
• /plot list, /plot show, /plot add <player>, /plot remove <player>, /plot delete: Updated with configurable messages.

1. Back up your existing plots.db (if you have one) and config.yml.
2. Replace the old PlotPlugin JAR with the new version in your plugins folder.
3. Restart your server to generate the updated config.yml.
4. Review and customize the new config.yml to your liking.

• The database schema remains the same, so your existing plots will carry over without issues.
• If you encounter any bugs or have feature suggestions, please let me know in the discussion section or on Discord!