Textventbox

From SP World Wiki
Revision as of 12:31, 3 October 2023 by Octopus58 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Textventbox
Textventbox Logo by SpicyCoffee
Developers
Developers:
Publishers:
Artists:
Composers:
Extra Credits:
Release Information
Series: SP
Genre: Adventure
Modes: Single Player
Platforms: ME-OS
Release Date: January 18th, 2022

Textventbox is a "choose your own adventure" text game engine made by Octopus58. It was released as part of the 0.0.49 update to ME-OS, and allows users to play text stories stored on the OS as well as create and share their own text games.

Gameplay

This game engine has a multiple commands that allow the story to be played. Usually, the basic format is having text, images, and music followed by 1-4 prompts. The player can then click buttons 1-4 to continue. Pressing the space bar also advances text prompts and other events quicker.

If a user wants to write their own game, all they have to do is make a folder with the resources they'd like to use such as images and music. However the most important file in the folder must be the game.txt folder, which has all the instructions written in a simple top to bottom style. An example game is provided (File:TextventboxShortExample.zip) that showcases basic commands being used as well as the folder structure.

Base Game Stories

Textventbox comes with the following stories included with the OS:

Story Author Description
The Hills Octopus58 This story, the player plays as themselves, except they are somehow awoken in Sunset Hill in SP. They must navigate their surroundings and figure out what to do about their stay.
Screenshot of a scene from "The Hills" story featuring Gontaper, Gonaper, Guppy and Guppette
Main menu of Textventbox, where you can either pick a local game or external game

Commands

The following symbols can be used to create a game in Textventbox:

Command Description Example
: Used to denote a heading
   :testheading
    
   - Will set a heading called testheading
DELAY Specifies a delay in seconds
   DELAY 0.5
    
   - Will delay execution until the next line for half a second
EXIT Exits the game and goes to Textventbox menu
   EXIT
    
   - Leaves to Textventbox main menu
GOTO Jump to a different heading. Headings are made by writing :exampleheading as a line anywhere in the text file
   GOTO(testheading)
    
   - Will go to the line marked as :testheading
IMGEXT Loads an external image. Must be in the folder included with the game.txt file
   IMGEXT: destination.png
    
   - Will load an image from your game folder called destination.png
IMGLOC Loads a local image from ME-OS
   IMGLOC: E/GameFiles/Textventbox/Preloaded/TheHillsFiles/menuimg
    
   - Will load a local image from E/GameFiles/Textventbox/Preloaded/TheHillsFiles/ called menuimg
MLOADEXT Loads an external music file. The file has to be in the same folder as game.txt. Doesn't play immediately!
   MLOADEXT: song.mp3
    
   - Will load song.mp3 from your game folder
MLOADLOC Loads a local music file from ME-OS
   MLOADLOC: E/Music/Dreamy/Emmy
    
   - Will load a local song from from E/Music/Dreamy/ called Emmy
MLOOP Sets the music to loop. Off by default
   MLOOP: true 
    
   - Will set the music to loop
MPITCH Sets the pitch of the music. 1 by default
   MPITCH: 0.5
    
   - Will set the current audio pitch to 0.5
MPLAY Plays the currently loaded song (if any)
   MPLAY
    
   - Will play the currently loaded song, if any
MVOL Set's the volume of the music player. 1 is maximum
   MVOL: 0.5
    
   - Sets the music player volume to 50%
OPT Allows you to set up to four options to choose from (you can have less than 4). Most important command in the game!
   OPT:start game(GOTO begin)|Mute Game(MVOL 0)|Leave(EXIT)
    
   - This will give the player 3 options. Start the game and go to the begin heading, mute, or leave and go to menu
TEXT Sets the text prompt for the user to read
   TEXT: This text will show up in big letters at the bottom of the screen.
    
   - The black bar at the bottom of the screen will now read: This text will show up in big letters at the bottom of the screen.

Development

This game engine has started to get work shortly before ME-OS version 0.0.49 released. It was a consideration for the future, but a suggestion from a beta tester to make it sooner triggered it's early implementation.

Music

Textventbox does not have any default music. However the games you open might have multiple tracks in them.

External Links

Trivia

  • Animated sequences can be made by loading in images followed by a delay for how long to wait before showing the next image.
  • The first included Textventbox game was "The Hills".