Computer Station Adventure

Computer Station Adventure

Transform your server's computer stations into retro gaming terminals with single-player adventures AND multiplayer games!

---

Description

Computer Station Adventure brings classic gaming to Rust. When players sit down at any computer station, they can launch into immersive gaming experiences—complete with an authentic retro CRT terminal aesthetic.

The plugin supports THREE game categories:

• Story Mode: Choose-your-own-adventure style with clickable choices
• Text Adventure Mode: Classic parser-based games like Zork (type commands)
• Multiplayer Games: Challenge other players OR the CPU to classic board and card games!

Whether your players are taking a break from raiding, waiting out a storm, competing with friends, or just looking for something different, this plugin delivers engaging experiences right inside the game world.

---

Features

IMMERSIVE TERMINAL EXPERIENCE

• Authentic CRT monitor visual overlay
• Classic green-on-black terminal styling
• Retro sound effects for interactions
• Fully customizable colors and appearance
• All images loaded locally for fast performance

MULTIPLAYER GAMES (8 Games!)

• Battleship: Classic naval combat - place your fleet and sink your opponent's ships
• Connect Four: Drop pieces to connect four in a row
• Tic Tac Toe: The timeless X's and O's game
• Checkers: Jump and capture to victory with king promotions
• Chess: The ultimate strategy game with full piece movement and check/checkmate detection
• UNO: The classic card game supporting 2-4 players with full rule set
• Risk: Epic world domination with territory control, armies, and strategic conquest
• Stratego: Classic military strategy with hidden pieces and tactical combat

CPU OPPONENT SYSTEM

• Play ANY multiplayer game against the computer when no friends are available
• Intelligent AI with game-specific strategies:
• Battleship AI: Smart targeting patterns, hunt mode when ships are hit
• Connect Four AI: Blocks winning moves, sets up combos
• Tic Tac Toe AI: Minimax algorithm for perfect play
• Checkers AI: Evaluates piece positions, prioritizes kings and captures
• Chess AI: Full move evaluation, piece values, positional scoring
• UNO AI: Strategic card selection, color optimization
• Risk AI: Territory evaluation, strategic reinforcement and attacks
• Stratego AI: Aggressive scouting, piece value assessment, randomized setup
• AI Chat System: CPU opponents have personality! They greet you, react to gameplay, and comment on wins/losses
• Configurable AI chat frequency and messages

MULTIPLAYER FEATURES

• Player vs Player OR Player vs CPU for all games
• Player invite system with accept/decline
• Pending invite notifications right on the main menu
• Real-time turn-based gameplay
• In-game chat system for player communication
• Beautiful game board images and piece graphics
• Works across any computer stations on the server

STORY MODE ENGINE (Choose Your Own Adventure)

• Branching narrative paths with multiple endings
• Inventory system for collecting and using items
• Resource counters for survival-style mechanics
• Conditional choices based on items, flags, and stats
• Weighted random outcomes for unpredictable events
• On-screen stat tracking (food, ammo, health, etc.)

TEXT ADVENTURE ENGINE (Parser-Based)

• Classic Infocom-style text parser ("go north", "take sword", "attack troll")
• 150+ built-in verbs (movement, combat, inventory, puzzles, etc.)
• Full room/item/NPC system with descriptions
• Container system with nested containers and surfaces
• Light/dark mechanics with fuel-based light sources
• Combat system with hostile NPCs, weapons, and health
• Scoring system with treasures and achievements
• Save/load game progress
• Fully scriptable events, puzzles, and interactions
• 100% data-driven - create entire games from JSON alone

COMPLETION REWARDS SYSTEM

• Reward players with items when they complete/win games
• Per-game reward configuration (different rewards for each game)
• Kits plugin integration - grant full kits as rewards
• Console command execution on win - add players to oxide groups, grant permissions, etc.
• Once-per-wipe option to prevent reward farming
• Server-wide announcements when players complete games
• Notify plugin integration for stylish notifications
• Automatic config updates - new games are detected and added to config

PLAYER-FRIENDLY

• Automatic progress saving between sessions
• Category-based game selection menu
• Pending multiplayer invites shown immediately when opening menu
• Pagination for stories with many choices
• Simple one-click access from any computer station
• Play against CPU instantly - no waiting for other players

SERVER ADMIN TOOLS

• Permission system for access control
• Admin permission for delegated management
• Easy JSON-based story/game format
• Hot-reload games without plugin reload (/adventurereload)
• Auto-detection of new games with config population
• Fully configurable UI positioning
• Local image storage - no external URL dependencies

---

Included Games

MULTIPLAYER GAMES (All playable vs CPU or other players):

Battleship

The classic naval combat game. Strategically place your fleet of 5 ships, then take turns firing at your opponent's grid to locate and sink their ships. First to sink all enemy ships wins! Features ship placement with rotation, hit/miss markers, and ship status tracking. CPU uses intelligent hunt-and-destroy targeting.

Connect Four

Drop colored pieces into the grid, trying to connect four of your pieces in a row—horizontally, vertically, or diagonally. Simple to learn, challenging to master! CPU evaluates threats and opportunities to provide a real challenge.

Tic Tac Toe

The timeless game of X's and O's. Take turns placing your mark, trying to get three in a row while blocking your opponent. CPU uses optimal strategy for competitive gameplay.

Checkers

The classic strategy board game. Move diagonally, jump to capture opponent pieces, and reach the opposite end to crown your pieces as kings. Capture all enemy pieces to win! CPU prioritizes captures and king promotions.

Chess

The king of strategy games. Full implementation with all piece movements, castling, en passant, pawn promotion, check detection, and checkmate/stalemate conditions. CPU evaluates positions using piece values and board control.

UNO

The beloved card game for 2-4 players! Match colors or numbers, use action cards to skip, reverse, or force opponents to draw. Call UNO when you're down to one card, and be the first to empty your hand to win! Play with friends or CPU opponents.

Risk

Conquer the world! Control territories, build armies, and wage strategic warfare across continents. Features territory drafting, reinforcement phases, attack dice rolling, fortification, and card sets. Supports 2-6 players with any mix of humans and CPU opponents. CPU evaluates continental bonuses and strategic positions.

Stratego

Classic military strategy with hidden information. Deploy 40 pieces including the Marshal, Generals, Miners, Scouts, Spies, Bombs, and your Flag. Pieces remain hidden until combat reveals them. Capture the enemy flag to win! Features randomized CPU setup, aggressive AI tactics, and 1-turn piece reveal memory system.

STORY MODE GAMES:

The Oregon Trail

Travel 2,040 miles from Independence, Missouri to Oregon City in 1847. Manage food, ammunition, medicine, and money as you face river crossings, disease, harsh weather, and countless life-or-death decisions. A fully-featured recreation with resource management, hunting, trading, and multiple paths to victory—or death.

Pirate's Treasure

Hack into a mysterious pirate radio frequency and follow cryptic clues across a remote island. Explore beaches, jungles, and hidden caves while collecting three ancient gems needed to unlock the legendary treasure. Multiple locations, secret passages, and puzzle-solving await.

Abandoned Facility (Horror)

Something went wrong at the old research facility. Access corrupted security logs, piece together what happened, and try not to become the next victim. Atmospheric horror storytelling with tension-building choices.

Fallout Wasteland

Survive in a post-apocalyptic wasteland. Scavenge for supplies, encounter other survivors, and make difficult moral choices in a world where resources are scarce and danger lurks around every corner.

Rust Survival

A meta-adventure set in a world suspiciously similar to the one outside the computer station. Gather, craft, build, and survive—all through text commands on a terminal screen.

TEXT ADVENTURE GAMES:

ZORK I: The Great Underground Empire

The legendary 1980 Infocom classic, fully recreated. Explore the ruins of an ancient empire lying beneath the white house. Collect 19 treasures, battle dangerous creatures including trolls, thieves, and the infamous grue, and discover the secrets of the Great Underground Empire. Features 116 rooms, 104 items, 5 NPCs, and 350 points of adventure.

---

CPU Opponent Details

Every multiplayer game includes a fully-functional CPU opponent:

BATTLESHIP CPU

• Hunts in patterns until finding a ship
• Switches to "destroy mode" after a hit
• Systematically targets adjacent cells
• Returns to hunting after sinking ships

CONNECT FOUR CPU

• Looks for winning moves first
• Blocks opponent's winning threats
• Builds toward multiple connection opportunities
• Avoids setting up opponent wins

TIC TAC TOE CPU

• Uses minimax algorithm
• Plays optimally - will never lose
• Takes center and corners strategically

CHECKERS CPU

• Prioritizes capture chains
• Values king pieces highly
• Advances pieces toward promotion
• Protects back row when possible

CHESS CPU

• Evaluates all legal moves
• Considers piece values (Queen=9, Rook=5, etc.)
• Factors in positional advantages
• Detects and executes checkmate patterns

UNO CPU

• Plays matching cards strategically
• Saves wild cards for emergencies
• Chooses optimal colors based on hand
• Properly calls UNO with one card remaining

RISK CPU

• Evaluates continent control opportunities
• Reinforces strategic territories
• Attacks when odds are favorable
• Fortifies border territories

STRATEGO CPU

• Randomizes piece placement each game
• Uses Scouts aggressively to probe defenses
• Protects high-value pieces (Marshal, General)
• Attacks with expendable low-rank pieces
• Remembers revealed enemy pieces for one turn

AI CHAT SYSTEM

• CPU opponents have unique personalities
• Greetings at game start
• Reactions during gameplay (captures, good moves, etc.)
• Victory/defeat messages
• Configurable chat frequency (default 10%)
• Adds immersion and entertainment to solo play

---

Permissions

computerstationadventure.use — Allows players to access adventure games

computerstationadventure.admin — Allows use of admin commands (/adventurereload)

---

Commands

/adventurereload — Reload all stories, text adventures, and multiplayer games (Admin or permission required)

---

Configuration

{
  "UI Background Color": "0.02 0.05 0.02 0.98",
  "UI Text Color": "0.2 1 0.2 1",
  "UI Button Color": "0.05 0.2 0.05 0.9",
  "Enable Sound Effects": true,
  "Allow Progress Saving": true,
  "Use Monitor Image": true,
  "Monitor Screen Area - Anchor Min (x y)": "0.07 0.15",
  "Monitor Screen Area - Anchor Max (x y)": "0.93 0.93",
  "Enable Completion Rewards": true,
  "Rewards - Once Per Wipe Only": true,
  "Announce Rewards In Chat": true,
  "Reward Announcement Message": "<color=#7fc97f>{player}</color> has completed <color=#ffd700>{game}</color> and received rewards!",
  "Use Notify Plugin": false,
  "Notify Type (Player Reward)": 0,
  "Notify Type (Broadcast)": 0,
  "Game Completion Rewards": {
    "battleship": {
      "Kit Name (leave empty to not give a kit)": "",
      "Items": [
        {
          "Item Shortname": "scrap",
          "Amount": 100,
          "Skin ID": 0,
          "Display Name (optional)": ""
        }
      ],
      "Console Command (use {steamid}, {playername}, {gameid} placeholders)": ""
    },
    "zork1": {
      "Kit Name (leave empty to not give a kit)": "",
      "Items": [
        {
          "Item Shortname": "scrap",
          "Amount": 250,
          "Skin ID": 0,
          "Display Name (optional)": ""
        }
      ],
      "Console Command (use {steamid}, {playername}, {gameid} placeholders)": "oxide.usergroup add {steamid} winners"
    }
  }
}

CONFIGURATION OPTIONS:

UI Settings:

• UI Background Color: Terminal background color (RGBA)
• UI Text Color: Text color for all UI elements (RGBA)
• UI Button Color: Button background color (RGBA)
• Enable Sound Effects: Play retro sounds on interactions
• Allow Progress Saving: Save player progress between sessions
• Use Monitor Image: Display CRT monitor frame overlay
• Monitor Screen Area: Position of the game screen within the monitor frame

Reward Settings:

• Enable Completion Rewards: Master toggle for the reward system
• Rewards - Once Per Wipe Only: Players can only earn rewards once per wipe (per game)
• Announce Rewards In Chat: Broadcast when a player completes/wins a game
• Reward Announcement Message: Customizable message ({player} and {game} placeholders)
• Use Notify Plugin: Use Notify for notifications instead of chat
• Notify Type: The notification type ID for Notify plugin

Per-Game Rewards:

• Kit Name: Optional kit to grant via Kits plugin
• Items: List of items to give (shortname, amount, skin, custom name)
• Console Command: Server command to run on win (supports {steamid}, {playername}, {gameid} placeholders)

CONSOLE COMMAND EXAMPLES:

• Add to oxide group: "oxide.usergroup add {steamid} winners"
• Grant permission: "oxide.grant user {steamid} someplugin.vip"
• Run custom plugin: "customplugin.reward {steamid}"

AUTO-CONFIG POPULATION:

When new games are added to the Stories, TextAdventures, or Multiplayer folders, the plugin automatically detects them and adds default reward entries to the config. Just run /adventurereload or reload the plugin to pick up new games.

---

Optional Plugin Support

Kits

• Grant kits as completion rewards
• Configure kit name per game in the config

Notify

• Display stylish notifications instead of chat messages
• Separate notification types for player rewards and broadcasts

---

Installation

1. Place ComputerStationAdventure.cs in your oxide/plugins folder

2. Extract the data folder contents to oxide/data/ComputerStationAdventure/

3. Configure rewards in the generated config file

---

File Structure

oxide/

├── plugins/

│   └── ComputerStationAdventure.cs

└── data/

    └── ComputerStationAdventure/

        ├── Images/                     (Game images - monitor, pieces, cards, boards, etc.)

        ├── Stories/                    (Story Mode games - JSON files)

        ├── TextAdventures/             (Text Adventure games - JSON files)

        └── Multiplayer/                (Multiplayer game configs - JSON files)

---

Credits

Plugin developed with passion for classic gaming

Zork I content based on the original 1980 Infocom game by Marc Blank and Dave Lebling

---