Skip to content

README.md

Latest commit

 

History

History
119 lines (90 loc) · 3.88 KB

README.md

File metadata and controls

119 lines (90 loc) · 3.88 KB

🏝️ MyIslandGame

An island-based survival and ecosystem simulation game where players explore procedurally generated islands, interact with evolving wildlife, gather resources, and build structures. Built with MonoGame and C#.

Current Version License Status

About

MyIslandGame combines resource management with deep ecosystem simulation. Your actions have real consequences on the environment and its inhabitants.

Key Features (Planned)

  • Living Ecosystem: Animals and plants form a complex food web with interdependent species
  • Entity Evolution: Creatures evolve over generations, adapting to your actions and the environment
  • Resource Extraction: Everything you craft comes from the world with visible environmental impact
  • Survival Elements: Navigate day/night cycles, weather, and hunger systems
  • Procedural Generation: Explore unique islands with their own resources and challenges

Current State

The game is in early development (v0.0.3-alpha). Current features include:

  • Entity Component System architecture
  • Basic movement and collision detection
  • Simple rendering of placeholder graphics
  • Input management system
  • Game state management
  • Camera system with zoom and player following
  • Tile-based procedural map generation
  • Day/night cycle with visual effects
  • Resource system with different resource types
  • Environmental objects (trees, rocks, bushes) with harvesting mechanics
  • Inventory system with hotbar
  • Resource gathering with tools

See the RELEASE_NOTES.md for detailed information about the current version.

Screenshot

Coming soon - currently just colored rectangles for development!

Development Roadmap

v0.0.2 (Released)

  • Camera system with zoom and player tracking
  • Tile-based procedural world generation
  • Day/night cycle with lighting effects
  • Basic UI framework with debug information
  • Player movement and world boundaries

v0.0.3 (Released)

  • Resource system with different resource types
  • Environmental objects (trees, rocks, bushes) with regrowth
  • Inventory system with hotbar and UI
  • Resource gathering mechanics with tools

v0.0.4 (Planned)

  • Crafting system for creating tools and items
  • Building mechanics for player structures
  • Basic ecosystem with animals and plants
  • More environmental variety and biomes

Future

  • Entity evolution system
  • Weather and environmental effects
  • Building mechanics
  • Advanced ecosystem simulation

Development Setup

Prerequisites

Installation and Running

# Clone the repository
git clone https://github.com/jacuzzicoding/MyIslandGame.git
cd MyIslandGame

# Install dependencies (Mac users)
# Mac users may need to install freetype6 library
brew install freetype

# Build and run
dotnet build
dotnet run

Controls

  • WASD/Arrow Keys: Move player
  • E: Toggle inventory
  • 1-9: Select hotbar slots
  • Mouse Wheel: Cycle through hotbar
  • Left Click: Gather resources / Use selected item
  • +/-: Zoom in/out camera
  • T: Speed up time (5x)
  • R: Reset time to 8:00 AM
  • ESC: Quit game

Architecture

The game uses an Entity Component System (ECS) architecture:

  • Entities: Simple containers with unique IDs
  • Components: Data containers attached to entities (Transform, Sprite, etc.)
  • Systems: Logic that processes entities with specific component combinations

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • MonoGame community
  • Inspiration from games like Stardew Valley, Animal Crossing, and Vintage Story

More details as development progresses