Home-Base

🏠 HomeBase v2.1

Advanced Base, Raid, Team & Combat Systems for Paper Servers

Developed by ColonelVoidRex v1.0-v2.1

HomeBase is a powerful all-in-one survival management plugin for Paper servers. It combines bases, raids, teams, combat tagging, safe zones, and live HUD systems into a single optimized plugin designed for competitive survival, factions-style gameplay, and anarchy servers.

Version 2.0 is a major rewrite introducing raid mechanics, team territory, combat logging penalties, a live action bar HUD, Discord integration, and a fully configurable safe-zone system.

⚔️ Core Systems 🏠 Base System

Players can create and manage their own bases with persistent tracking.

Features:

/sethome [name] to create a base

Physical banner spawned in the world representing the base

Bases track:

coordinates

creation time

leak count

raid immunity

team ownership

Bases cannot be placed:

underground

in water

near other bases

inside safe zones

/homeinfo shows full base information

🏴 Banner Protection System

Every base and shop is represented by a physical banner structure.

Protection features:

Banner support block completely indestructible

Protected from explosions and pistons

Blocks cannot be placed on top

Only removable using plugin commands

⚔️ Combat Tag System

Prevents players from escaping fights unfairly.

Players are combat tagged for 3 minutes

Triggered when dealing or receiving damage

Teleporting blocked during combat

Logging out during combat:

Instant death

Server broadcast

Discord notification

Escalating penalties for repeated combat logging

Penalty tiers:

15 minutes

30 minutes

45 minutes

📊 Live Action Bar HUD

A dynamic live HUD system displays important status information.

Shows:

Combat timer

Teleport cooldown

Combat log penalty

Safe zone status

Raid status

Base leak status

Low altitude teleport warning

🏴 Raid System

HomeBase v2.0 introduces structured base raiding mechanics.

Raid process:

Raiders break an enemy banner

A raid event starts

A 5 minute boss bar timer begins

Raiders must stay within 50 blocks of the base

Raid success:

Timer reaches zero

Raiders remain within radius

Base is deleted

Raiders receive diamond rewards

Raid fails if:

Raiders leave radius

Raiders die

Raiders disconnect

Additional features:

Raid immunity after a successful raid

Owner notified instantly

Team members notified

All raid events sent to Discord

Raid modes:

Online only

Offline raiding

👥 Team Territory System

Players can create teams and share base territory.

Team features:

/createteam

/teaminvite

/inviteaccept

/teamkick

/teamleave

/delteam

Capabilities:

Shared territory base

All members teleport to territory with /home

Friendly fire toggle

Team raid notifications

Team information panel

When joining a team:

Personal home is automatically removed

Territory becomes the shared base.

🌍 Safe Zone System

Fully configurable safe zone protection.

Features:

Custom safe zone radius

Optional protections:

Block breaking

Hunger

Explosions

Fire

PvP disabled

Mob damage blocked

Players can still attack mobs

Safe zone entry / exit messages

Homes cannot be placed inside the safe zone.

📡 Discord Integration

Optional Discord webhook support.

Events sent to Discord:

Player chat

Server broadcasts

Raid events

Leak events

Combat log broadcasts

Team creation & disband

Plugin lockdown events

🧨 Leak Event System

Admins can trigger a global base leak event.

How it works:

One random base is selected

Countdown boss bar displayed

Milestone broadcasts:

Start

30 seconds

10 seconds

Final countdown

Coordinates revealed at the end

During leak events:

Home modifications are locked

Leak count tracked per player

🌀 Teleportation System

Teleportation is balanced to prevent abuse.

Features:

5 second teleport warmup

Movement cancels teleport

1 minute teleport cooldown

Minimum Y-level check prevents underground teleports

Team members teleport to team territory

🛡️ Admin Tools

Powerful moderation utilities.

Commands:

/hbinfo full player report

/hbclearpenalty

/pluginlock

/pluginunlock

Plugin lockdown instantly disables all plugin functionality for emergencies.

🎵 Fully Configurable

Most systems can be configured:

Welcome message

Join sound

Teleport sound

Combat log penalties

Safe zone rules

Raid timers

Raid rewards

Leak countdown

Discord integration

📜 Commands Player Commands /sethome [name] /home /delhome /homeinfo [player]

/createteam /teaminvite /inviteaccept /teaminfo /teamleave /teamkick /delteam

/friendlyfireon /friendlyfireoff

/serverinfo /toshop Admin Commands /setshop /delshop /leakbase /cancelleak

/hbinfo /hbclearpenalty

/pluginlock /pluginunlock 🔧 Built For

Survival servers

PvP servers

Factions-style gameplay

Anarchy servers

Community servers with global shops

⚡ Highlights of v2.0

Live action bar HUD

Team territory system

Structured raid mechanics

Banner-based bases

Combat logging penalties

Discord webhook integration

Massive safe zone improvements

Advanced leak events