sebastianluczak / php-roguelike

Simple RPG text game done as a side project using Symfony components

php-roguelike

What is this?

PHP Roguelike is a console (CLI) based game driven by rogulike scheme based progression. You'll die. A lot. Embrace it and go further and further, discovering new bosses and trying to beat high score.

This game is done as a part of side-project to show'up some programming skills in PHP. You're welcome to give ideas and put some PR's.

Trivia

J: Mom, can we have ADOM at home?

M: But we have ADOM at home...

Meanwhile, ADOM at home:

Purpose

It's so fun to fiddle with some side-project and have a time sink for myself. I was missing side project and playground/testing area to experiment and keep on track with everything. I'll produce a roadmap in some time to see some final goal and keep myself motivated.

Influences

Ok, so in fact I've gathered a few ideas from different games. Most notably you'll see elements from:

• Dungeons and Dragons
• Fallout
• ADOM
• Enter the Gungeon

Run & build

Prerequisites:

• Docker with Docker Compose
• Terminal Emulator capable of displaying rich text and XTERM256 support

cd ~
git clone https://github.com/sebastianluczak/php-roguelike.git
cd php-roguelike
chmod +x bin/*
bin/build.sh

Keymap

See: Keymap

W/A/S/D - Movement of character
I - Player Interface (WIP)
L - show Leaderbords
Q - quits the game
H - use Healing Potion

-- 
DEV_MODE
R - regenerates the level
P - switches DevMode (required for some output and commands)
R - regenerate a map (DEV_MODE required) 
M - DevRoom :D (╯°□°)╯︵ ┻━┻ 
G - God Mode!
K - Increase MapLevel

Win/Lose conditions

As all roguelikes - you'll die eventually. It's just part of the process. Your score will be written down in LeaderBoards. Try to achieve best score!

Legend

There are multiple tiles with scattered logic all around the board.

# - Chest or RareChest - guaranteed drop of Item, Gold or Health Potion
$ - Mysterious Man - can do good things for you
* - Boss Fight - be prepared!
o - Altar, drop some gold for a buff or curse

Go figure the rest by yourself, see here to get started. No documentation folks :).

Win strategy

1. Go for Luck > 1
2. Hoard Chests for life
3. Try to stay alive (visit ShopTile and AltarTile as often as you can)
4. Fight small creatures (luck based)
5. Visit Chests
6. Go for max Health Regen from buffs
7. (wait for it, wander around)
8. Fight BOSS
9. Die and repeat
10. PROFIT

API

WHAT THE HECK?! RPG cli game in PHP with API?!

Visit 127.0.0.1/api and check and check out some neat features we're planning, like:

• complete access to current state of the game being played via API
• custom, high risk - high reward type one hit dungeons/mazes
• NPC Dialogue API and CreatureProvider moved to microservice

My plan is to be able to change/update/set state of player dynamically via API. I know I'm far from it because logic is inside loop of the game but ...

php-roguelike's Issues

Add developer mode to either debug or activate some functions

Best done using feature flags maybe?

Fix persistence of leaderboards

Add keys drops

At some point player becomes unkillable, change game balance

Introduce D6/D4/D8 rolls where applicable

We need better randomness in underworld. Dice is the best.

Upgrade to PHP 8.x

Why

As a developer I want to use new features from the new version of PHP to increase my productivity.

How

We need to bump version in composer and check all libraries.

Add ways to spent money beside shopping

Money sinks are good, we need them.

Some ideas are welcome.

Add city Map

Add support for PHP 8

Optimize TileLogic by separating abstraction class

Add internal clock for events timing

Make optimizations in code to be able to scale it in the future. Prepare code base for microservice approach.

Leaderboards are not persisted due to Docker env

Create persisting layer for database, either sqlite (prefered) or something more sophisticated

Add more verbosity to player actions

Using Adventure Log

Add monster scaling based on Dungeon Level

We need to increase difficulity on each stage, player becomes unkillable at some point.

Add initiative rolls for player and creatures

It's how we determine if creature hits first or the player.

Add a way to quit game (killing process)

Game is unplayable on Windows

I won't deal with it right now.
You've got docker.

Create random events based on timer

i.e. if rand(1,6) minutes from last event launch event.
Events are bosses with different mechanics.
Bossess drop keys
Keys are for dungeons scattered in some levels.

DUNGEONS DLC!

Find a way to add truecolor support

Move OpenAPI start to SupervisorD

Add health pots as drops

Add inventory management for Player

Add randomness in damage dealt

Creatures should be able to fight on DiceService based conditions. Similar to D&D style.

Add boss event fight

Add validator for level complexity

There're ongoing issues with level generator:

1. Sometimes it does not generate proper level (empty map)
2. Sometimes it does not create spawn point
3. Sometimes the complexity is very low

Add random access Dungeons access for keys.

Add adventure log improvements

Add basic stats for Player