resaki1/taal

Taal is an open-source 3D browser game built with react-three-fiber that aims to combine the strategic depth of games like Anno and Civilization with an infinitely expansive, procedurally generated cubic world.

Taal: Civilizations Unleashed

Taal is an ambitious open-source 3D browser game that combines the strategic gameplay mechanics of games like Anno and Civilization, without being bound to a limited world by being set in an infinitely large, procedurally generated world of cubed tiles — all within your web browser.

Demo

Explore the world of Taal by checking out the demo!

Technologies

• Framework: React (TypeScript) with Vite
• 3D Rendering: react-three-fiber
• State Management: Zustand
• Hosting: Currently Firebase (will probably change in the future)

How to Contribute

Contributions to Taal are highly encouraged! Whether you're a developer, designer, or a gaming enthusiast, your input is valuable. There is a list of beginner-friendly issues labeled as Good First Issue to help you get started. Feel free to start discussions, propose new features, or directly open pull requests. Your creativity and expertise are welcome!

Project Direction

Taal's development is an exciting journey with an evolving vision. While I currently plan to incorporats elements inspired by Anno and Civilization, its future could potentially include:

Realistic Simulation: Aim to simulate real-life as accurately as possible, including:

• A large, detailed tech tree
• Creation of a unique religion that can spread (similar to Civilization)
• Introduction of a custom currency, dynamic market prices, and economic systems
• AI-controlled cities for trading and strategic interactions
• Multiplayer functionality for collaborative and competitive gameplay experiences

However, the direction of Taal is not set in stone. I am open to new ideas and perspectives. Your creativity might lead us in unexpected and innovative directions. Feel free to contribute your thoughts and proposals!

Get Involved

Your creativity, feedback, and ideas are really welcomed here. Join the Taal community today, and let's build an incredible gaming experience together!

Installation

To start Taal locally, clone the project and then run:

cd taal
npm i
npm start

taal's Issues

Update r3f, drei and three.js

Add way to manually deactivate buildings

deactivating a building deactivates all of its outputs
there should be a visual indicator that a building is deactivated (darkened and/or a visual indicator above it)

Bug: Map disappears

At a specific distance from the origin, the map randomly disappears (except for the water). This seems to be the case for all four directions.

Settings

Add a settings modal. For now, this should include:

• Settings button -> opens settings modal/page
• unlock camera movement (#24)
• Rendering distance

Settings should be stored in global state and persisted between reloads

Add option to export and import save state

Improve terrain

Right now, the terrain is randomly generated, but it pretty much looks the same everywhere.

There should be multiple levels of perlin noise maps (e.g., one for general terrain height, one for continents & oceans, etc.), similar to Minecraft.

dynamic shadows

Currently, the shadows are only in the initial playing area. When moving to a new area, there are no shadows (probably because the sun's position is not updated)

Limit camera movement

Right now, the camera can be moved freely. This should be limited.

• Should be limited for "normal" players
• Devs should be able to unlock the movement
• Maybe add a setting which can be toggled
• Activate unlocked movement per default in DEV environment

Add CI/CD pipeline

Should contain:

• install dependencies
• build project
• lint code

Optional:

• some basic tests

Add foliage

• grass
• trees
• snow?

Improved typings

Replace 'any' types with more specific types

Add Versioning

Implement punishment when resources are negative

There must be some "punishment" when a resource drops below 0

• imo it would make the most sense if buildings (including their outputs) are deactivated so that the total output is not negative anymore

Add login to store save state in cloud

Create logo

Create application logo for:

• favicon
• manifest.json (PWA)

3D building models

Create 3D models for existing buildings (and replace the third-party house model with a self-made one)

Check license

Store camera position

Random position for new players

Improve rendering performance

Check if rendering performance can be improved (it's fine on iPhone but bad on Intel MacBooks)

Implement UI

• create general UI theme
• implement new UI for existing elements

Add fog

Add fog so that the edges of the map are not visible

Add contributing guide

Refactor Code

• check if any code can be moved to separate, reusable components
• remove unused code

Explore Multithreading

See if any (expensive) calculations/actions can be outsourced to service workers

Add more resources and buildings

• - stone
• - - quarry
• • built on stone or next to it?
• - food
• - fishing hut
• - farm
• - hunting cabin
• - wool
• - farm
• - leather
• - hunting cabin
• - clothing
• - weaver
• - needs wool, leather or cotton
• - coal

Add security guideline

Security.md

Add teleportation

• display current coordinates
• add way to teleport to other coordinates

Improve terrain textures

• improve existing textures
• add missing textures

Add readme

Fix deletion of outposts

There are two issues when deleting outposts:

• all tiles in its radius are not unlocked anymore, even if another outpost is close
• nothing happens to the buildings in the radius of the deleted outpost
• when the last outpost is deleted, no new buildings can be placed and players are stuck

Bug: Wrong tile textures on iOS