Skip to content

MrBedrockpy/PointControl

Repository files navigation

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:

  1. The point starts assimilating
  2. Progress increases until capture duration is reached
  3. 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();
});

About

minecraft mod for capture points with minimalistic design

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages