PointControl

A lightweight Forge mod that adds capture points to Minecraft.
Players can fight for control of areas, and teams can capture and hold points to gain dominance.

Perfect for:

PvP servers
mini-games
faction battles
territory control systems
adventure maps

Points can be created anywhere and will automatically track nearby players and determine which team controls the area.

Features

Create capture points anywhere in the world
Automatic team dominance detection
Configurable capture duration
Customizable capture animations
Client HUD showing point status
Persistent points saved with the world
Event API for other mods

How It Works

A Point is a area in the world.

Players inside the area contribute to their team's dominance.

If one team has more players inside the area than others:

The point starts assimilating
Progress increases until capture duration is reached
The team becomes the owner of the point

If another team enters the area:

capture progress can decrease
the point can become contested
the point can be lost

Commands

All commands require operator.

Create a Point

Creates a new capture point at the player's position.

/point create <id> <radius>

Example:

/point create alpha 10

Creates a point with:

id: alpha
radius: 10 blocks

Remove a Point

Deletes an existing point.

/point remove <id>

Example:

/point remove alpha

List Points

Displays all existing points.

/point list

Example output:

Points: alpha, bravo, charlie

Change Capture Duration

Sets how long it takes to capture a point.

/point assimilation duration <id> <ticks>

Example:

/point assimilation duration alpha 60

Default value:

30 ticks

Higher values make capturing slower.

Change Capture Animation

Sets the animation used in the HUD.

/point assimilation animation <id> <animation>

Available animations:

up
down
in
out

Example:

/point assimilation animation alpha out

Configuration

Config file:

config/pointcontrol.json

Example configuration:

{
  "enableDeassimilationWhenNoPlayers": true,
  "deassimilationPeriod": 6
}

enableDeassimilationWhenNoPlayers

If enabled, capture progress will slowly decrease when no players are present.

deassimilationPeriod

Controls how quickly capture progress decays.

Lower values = faster decay.

HUD

When points exist, players will see a capture HUD on the screen.

The HUD displays:

point identifier
capture progress
controlling team color
capture animation

Team Support

The mod uses Minecraft scoreboard teams.

Example:

/team add red
/team add blue

Players must belong to teams for capture logic to work.

Developer API

PointControl provides simple events for mod integration.

Events

PointCaptureEvent
PointCapturedTickEvent
PointLostEvent

Example usage:

EventManager.POINT_CAPTURE.add(event -> {
    Point point = event.getPoint();
    Team team = event.getTeam();
});