~/projects/stranded

GAMES2025

Stranded

Two versions of a lives-based Minecraft survival minigame: the first built around OP items and timed whitelist access, the second around a lives/mutation system.

TIMELINE
May 2025 – Oct 2025
TEAM
Solo
CONTEXT
Personal project
Scoreboard diagram: players colored by remaining lives out of ten, each with their mutation icons.

Overview

Stranded is a lives-based Minecraft survival minigame built in two separate versions. Version 1 (Stranded) centers on a set of custom “OP items” players can earn and a scheduled server whitelist window; version 2 (Stranded2) replaces that with an explicit lives system and a pluggable “mutation” system that grants players persistent status effects.

Features

  • Stranded (v1): /givelives to grant extra lives and /opitem to give players special crafted items (a dirt-placing wand, an ice wand, a gravity-affecting crossbow)
  • Stranded (v1): time-based whitelist controller that automatically toggles the server whitelist on and off between configured hours
  • Stranded (v1): custom death/respawn/helmet/mob-death listeners tied to the lives system
  • Stranded2 (v2): /lives and /mutation commands for managing player lives and mutations directly
  • Stranded2 (v2): a Mutation interface with a MutationManager that registers, persists, and applies mutation effects (e.g. night vision, water breathing, jump boost) per player
  • Stranded2 (v2): a lives-based team/scoreboard system with color-coded thresholds (green/yellow/red/gray) based on remaining lives

How it works

Both versions are Paper plugins with a central GameManager tracking per-player lives. Stranded’s OP items are implemented as individual classes (DirtWand, IceWand, GravityCrossbow) under an OpItem interface dispatched by a shared item-interaction handler. Stranded2 generalizes the status-effect side of the game into a Mutation abstraction so new effects can be added as self-contained classes registered with MutationManager, which also tracks which mutations each player currently has.