This is a simple, read-only, terminal experience for tabletop RPGs. You can fork the project and change the code for your own configurations, like terminal name (or sector/station/node if sci-fi), image and messages.
The database is a simple JSON structured file.
You can host it on Github Pages for a free and fast experience and can share the link for your friends and players to use.
You can now configure and access extra servers at network.json
to login via telnet.
Each server will treat their respective users (and mail messages) separately.
You can now configure custom software at software.json
to use it.
They're just simple simulations, but I hope you enjoy it!
The help
command has been improved.
You can now show further help instructions for internal commands.
You can upload it to Github Pages or try it on your computer. You will find instructions for both options below.
You will want to customize the terminal depending on the game setting you're playing. You just have to edit the manifest.json
file.
More configuration files will be added when more functionality shows up.
The main server, which is where the terminal will start, is located as localhost
at config/network
.
The network
folder is where every server available needs to be. This is where you can configure new servers to be accessed via the telnet
command.
You need to create a folder with the name of the server address if you want to connect to custom servers.
Each server will have a distinct user list, mail messages, and server files. That is, you can't access data of a user configured on database.json
while you're at another server.
The basic configuration at manifest.json
is what you need to change to customize your terminal.
You can change the terminal year date, the server name, a customized icon, the terminal identification (this is what is written just before the cursor), as well as the default user id and name (normally this will be "user", but it can be whatever you want) and if you want a random number to be displayed right in front of the default username (randomSeed). Note however that, once you login to the server, the username will change.
{
"year": "2377",
"serverAddress": "localhost",
"serverName": "Node Y56 Intranet",
"iconName": "Moon-icon.png",
"terminalID": "Y56",
"defaultUser": {
"userId": "user",
"password": "",
"userName": "anonymous"
},
"randomSeed": true
}
{
"year": "1972",
"serverAddress": "127.0.0.1",
"serverName": "FBI: X-Files Division",
"iconName": "fbi.png",
"terminalID": "fbi",
"defaultUser": {
"userId": "user",
"password": "",
"userName": "anonymous"
},
"randomSeed": false
}
The userlist.json
file is where you will add your players as users of the main server, or the NPC users of other servers.
The basic structure of the file is as follows:
- userId: is the username identification for login
- password: is the password necessary to login
- userName: this is the name of the player character (if the terminal is where he check his emails) or the name of a npc (if he's hacking into someone else's computer/server)
You can register as many users and mail messages as you want. You just need to put a comma (,
) right after the correct enclosing }
. If you're in trouble, you can check a basic JSON tutorial, it's easy.
[
{
"userId": "8A73B5",
"password": "trustno1",
"userName": "Mulder, Fox"
},
{
"userId": "admin",
"password": "admin",
"userName": "root"
}
]
This is where you will register the server mails.
You can register as many mail messages as you want by adding a comma (,
) right after the correct enclosing }
.
You can register the same email for multiple users at once.
- from: the name of the person who supposedly sent the message
- to: a list of users who will have access to the message after login
- title: the title of the message that will be given when listing mail messages
- body: the actual message to be displayed after selecting it to be read
Note that user
will display the message for visitors if the defaultUser
userId
is registered as user
in the respective server manifest.json
.
In the body, you can break the line with a double space.
[
{
"from": "admin",
"to": ["8A73B5", "user"],
"title": "Maintenance in all servers",
"body": "This message is for all divisions of the Bureau. Starting today, the servers may suffer instability due to the latest maintenance measures. - admin"
},
{
"from": "Mike",
"to": ["admin"],
"title": "wtf are you kidding me?",
"body": "Are you kidding me? Why don't you change your password? The system is entirely compromised until you correct it. You're the sysadmin, if you're this dumb the corporation is at risk."
}
]
You can create your own custom software. At the moment you can just create simple software that will output some messages simulating an operation.
You just need to create a file with the name of the software terminating with .json
.
After setting everything up, you can just use it as the defined name.filetype (i.e. cdata.exe
command defined in cdata.json
).
- filename: the name of the file as metadata; this needs to be the same as the actual filename terminating as
.json
in the software folder - filetype: this is where you decide the file extension to call at the terminal
- location: here you can specify which servers will have access to the software (where it is installed); you need to specify at least
localhost
if you want it to run in the main terminal - protection: this is where you specify who can have access to the software, that is, which users have it installed (or which players have found it to use)
- delayed: this will create an effect to each message to be slowly printed at terminal, the number is in milliseconds
- message: the actual message to be displayed as an emulation of the software running
Note that you can set protection
as false
(boolean) if you want any user to access the software, and you can set location
as "all"
if you want every server to have access on it.
{
"filename": "cdata",
"filetype": "exe",
"location": ["127.0.0.1", "localhost"],
"protection": ["admin"],
"delayed": 2000,
"message": [
"Corrupting data.",
"Corrupting data..",
"Corrupting data...",
"0% complete",
"11% complete",
"47% complete",
"98% complete",
"System successfully corrupted!"
]
}
The main functions are the mail
and read
terminal operations.
Once you login
, you can call the mail
function to list the user emails, and you can read
the mails you want by entering the index code (the correspondent number, letter, or string).
As this is a simple terminal emulation, you can't delete mails or mark as read. We may be able to work it out in the future, but those basic functions are enough to send some cool mysterious mails to your players' agents, or emulate a character hacking into a company to investigate a clue or something.
To login you need to enter user@password
Note the change in the terminal username
How to list and read mails
You can try help
to see a list of other functions available. The clear
function may be a useful one.
As I've said, you can use Github Pages to do that for you. If you're not used to Github, first create a Github user by registering in Github, so you can "fork" the project to your account by accessing the project page email_terminal and by clicking in the "fork" button.
Note that those two in red are the only two steps you need to take to get your terminal up and running. You need to click the Fork button, and after a few seconds, the project will be there as one of your own repositories, and then you click the Settings button.
In the settings page, scroll down to the Github Pages section and select the source as the master branch.
After a few seconds, you will be able to access your terminal at username.github.io/email_terminal (i.e. jacksonbenete.github.io/email_terminal).
Note that you can create multiple repositories and name those repositories in the Settings for each of your game tables. That way you can have one terminal ready for each setting (or for each organization your players will hack into), ex:
- username.github.io/spacestationX22
- username.github.io/PenTexCorp
- etc
You just need to share the correct link with your players and wait for them to read the clues and investigate.
If you're testing this on your computer, you'll need to install a HTTP server because isn't possible to open and run files for security reasons. You need that for the AJAX to work to access the database file. It will work without problems once it is forked and running as a Github Page.
npm install http-server -g
Run it as http-server C:\location\to\app
or just http-server
if you're inside the directory. You can access it on 127.0.0.1:8080
in your browser. If you're debugging it, consider going to "Network" in the Inspector and disabling the cache.
This is really a simple terminal emulation, as I've said. But, there are some things that could be also good to explore, like the creation of some local files or executable programs for the players to interact with.
If you want to, drop some ideas into my Github repository or send me some messages at Reddit (u/jacksonbenete) and we can work out something else.
- Base code inspired by @AndrewBarfield, https://codepen.io/AndrewBarfield HTML5 Web Terminal.
- Moon-icon.png by: http://www.iconarchive.com/show/christmas-shadow-2-icons-by-pelfusion/Moon-icon.html and www.pelfusion.com
- tech.jpg icon by: https://favpng.com/png_user/GreatCthulhu
- cmd.png icon by: https://www.flaticon.com/br/packs/seo-and-web-5
- vision.svg icon by: https://www.flaticon.com/free-icon/company-vision_1465429
- world.svg icon by: https://www.flaticon.com/authors/turkkub
- fbi.png icon by: https://iconscout.com/contributors/icon-mafia
- (non-free) DNA icon by: https://www.iconfinder.com/icons/378473/dna_icon