Ranking & Rating

How the plot ranking and player rating systems work.

Ranking System

The ranking system calculates points for each plot based on the blocks placed within its territory. Different block types award different point values.

How It Works

  1. The plugin periodically scans blocks within each plot
  2. Each block type is assigned a point value from the configuration
  3. Total points determine the plot’s ranking position
  4. Rankings are displayed via /plot ranking or PlaceholderAPI

Block Points Configuration

Configure point values for different blocks in the block-points section:

block-points:
  DIAMOND_BLOCK: 100
  EMERALD_BLOCK: 80
  GOLD_BLOCK: 50
  IRON_BLOCK: 30
  STONE_BRICKS: 5
  OAK_PLANKS: 2

Tip: Only blocks listed in the configuration contribute to ranking points. Unlisted blocks award 0 points.

Ranking Cooldown

Ranking recalculation has a configurable cooldown (default: 600 seconds) to prevent excessive server load.

Viewing Rankings

  • /plot ranking β€” shows the top ranked plots in chat
  • PlaceholderAPI: %minePlots_top_points_name_<position>% and %minePlots_top_points_points_<position>%

Rating System

Players can rate plots they visit using a 1-5 star system.

How It Works

  1. Stand on any plot that you don’t own
  2. Run /plot rating <1-5>
  3. Your rating is saved and the plot’s average is updated
  4. Each player can only rate a plot once (overwrites previous rating)

Configuration

broadcast-plots-ratings: true

When enabled, rating changes are broadcast to notify the plot owner and nearby players.

Viewing Ratings

The average rating is available through:

  • The plot Dashboard GUI
  • PlaceholderAPI: %minePlots_rating%
  • /plot info command