The rpg language is a compiled esoteric programming language that writes like an rpg game.
- Download
- Tools
- Contributing
- Using the cli
- Examples
- Bugs
- Contributing
- Specification
- Questions
- Other links
- License
You will need the Rust compiler to compile this language alongside the rpgc cli.
You can download the Rust compiler from rust-lang.org.
But, in short, run curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh on Mac or Linux.
For Windows, you can download a standalone installer.
You can then download the rpgc cli manually:
If you have HomeBrew installed, you can also run:
brew tap rpgc && brew install rpgc
Current version: v0.1.1
- MacOS: 64-bit 10.7+
- Linux: 64-bit (kernel 4.2, glibc 2.17+)
- Windows: 64-bit Windows 7+
If you need a 32-bit binary, you can compile the cli manually by running cargo build --release inside of the rpg-cli folder .
This will build the cli for your machine and put it in the target/release folder
To make writing in this language easier, there is a VSCode extension for syntax highlighting. You can get it from the VSCode Marketplace.
If you use a different IDE and want to add support for RPG, feel free to open a pull request!
I welcome all contributions. Feel free to open an issue about anything and optionally a pull request.
Also, if you want to, please take a look at the issues, some of them are improvements I want to make, others are bugs that need ot be fixed. I could use soe help with them.
To compile your rpg program, you can use the cli:
rpgc path/to/source.rpgThis command will create an executable file called rpg at your current location (rpg.exe on Windows). Make sure you don't have a file called rpg there, as it will be overwritten.
To run your program, run ./rpg. You can also combine these 2:
rpgc path/to/source.rpg && ./rpgIf something doesn't seem to work, you can always use the -v or --verbose flags to see if any errors occured.
If they did, please open an issue as these kinds of errors are usually bugs in the compiler.
rpgc rpgc path/to/source.rpg -vFor more commands, use rpgc help.
If you have installed the cli using the manual downloads, you can run it using ./rpgc or by moving it to your bin directory.
You can find the examples in the examples folder.
I have tested the compiler, but since this is still the first version, there might be some bugs, so feel free to open an issue.
Actors are either a character or a zombie. They have 2 variables called health and attack. They also have an inventory to hold items. The maximum amount of actors allowed per game (e.g. per program) is 10. Characters will disappear when they die (e.g. when their health is 0), but zombies won't disappear when their health is 0 or below. They need to be converted to a char
Characters can cast more spells, but can't have negative health, while zombies can have negative health.
Characters have 2 variables health and attack, both are unsigned 32-bit integers.
A character called "ash" with health of 5 and attack of 3:
char ash = (5, 3)
Zombies are actors that can have negative health (signed 32-bit integer). They can be converted to a regular character using the un_zombify spell.
zombie walker = (-4, 6)
Potions have 1 variable called healing and can be used to heal an actor. Actors buy these potions from merchants and need to buy them as many times as they will use the potion.
potion p = (5)
Spell books are used for casting different spells.
spellbook eucharidion = ()
Merchants sell items. Actors can buy these items and will hold them in their inventory.
merchant cabbage = ()
Actors buy items from merchants using buys
actor buys item from merchant
Actors can attack each other, this subtracts the attack of the attacking actor from the health of the actor being attacked.
char a = (10, 3)
char b = (2, 5)
b attacks a
# a will now have 10 - 5 = 5 health
Actors can use items in their inventory.
potion p = (5)
char a = (5,0)
merchant m = ()
a buys p from m
a uses p
# a will now have 5 + 5 = 10 health
Characters can shout their health. This will output a new line.
char a = (1,0)
a shouts
a shouts
# output:
# 1
# 1
Characters can whisper their health. This will output without a new line.
char a = (1,0)
a whispers
a whispers
# output:
# 11
Characters can use spell books to cast spells. The spell name is
followed by () or (param)
This will read whatever number the user inputs
input uses spellbook casting god_speech()
This will print the ASCII value of the health of the actor
char jeremy = (33,1)
spellbook eucharidium = ()
merchant cabbage_man = ()
jeremy buys eucharidion from cabbage_man
jeremy shouts eucharidion casting speak()
# output:
# !
The time warp performs the lines beneath it until it reaches the end keyword, at which point it will go back to the
beginning and performs the lines again. To do this, it will require an offer. It will perform this loop until the offered
character has no health left.
The health of the character being consumed is subtracted at the end of the lines.
# We have 2 characters: david (5 health) and ella (5 health). David has a spellbook in its inventories
david uses spellbook casting time_warp(ella)
ella shouts
end
# Output:
# 5
# 4
# 3
# 2
# 1
Converts a zombie to a character.
james_brown uses spell_book casting un_zombify(zombie1)
When a character is confused, it will output its health - 1 when shouting or whispering.
steven uses spell_book casting confuse(other_char)
other_char shouts # Will output the other_char's health - 1 e.g. other_char = (1,2), so the output will be: 0
Characters can change the value of a potion
char sans = (6, 1)
potion p = (5)
sans buys p from merchant
sans uses spellbook casting create_potion(p)
sans uses p
sans shouts
# Output:
# 12 (6 + 6)
Shift swaps a character's health and attack.
char Ness = (2,1)
Ness uses spellbook casting shift()
Ness shouts
# Output:
# 1
If you have any questions, feel free to ask them by opening an issue!
The compiler and programming language are licensed under the MIT License.