Full-featured game console based on pygame that can be integrated in your python game in order to execute python command/scripts/custom in-game functions
- fully configurable look&feel via json - fonts, pictures, commands, console layouts, paddings, scrolling text and more
- history of inputed commands available upon pressing up/down buttons
- scrollable output available upon pressing pgUp/pgDown buttons and/or mouse wheel
- configurable transparency and wallpaper support
- optional header/footer text that can contain dynamic in-game values (time, fps, anything else)
- header/footer layouts supporting scrolling and more
- optional fluent animation during showing/hiding of the console
- commands implemented as a separate python scripts
- support for running custom scripts (batches of console commands) with parameters
- support for colored texts, big inputs, big outputs
- easy integration into your existing code
All console logic is implemented in the pygame_console package. Example game with console implementation is in example_game.py.
Folders console_commands, console_scripts and console_configs contain configurable console logic tailored for given game. Those can be further modified/extended to implement more logic / commands / scripts into the console.
Make sure you have pygame >= 1.9.4 installed and run the code.
-
You will see pygame window with rectancle moving in random directions - simulation of game
-
By pressing F1 button you can toggle on/off console
-
By pressing Esc key or closing the window or typing 'exit' will end the program
When instanciating Console class you need to specify reference to the main game class that you want to manage. Instance of this class is then referenced as 'game'. Using console, you can then use standard python code with this instance. Python commands must start either with 'shell' keyword or simple exclamation mark '!'.
Examples of couple python commands that can be used with the example game are below:
shell print('Hello world')# Prints Hello world on console!print('Hello world')# Same as above!game# Prints <main.TestObject object at 0xXXXXXXXX> i.e. reference to the main object that is govern by the console!game.pos = [10,10]# Changes position of the game rectancle!game.surf.fill((0,0,0))# Changes the color of the game rectancle from white to black!game.console.padding.up = 30# Changes the space between upper console corner and first console element (header or other depending on console layout settings)!game.cons_get_time()# Prints output of the function on the console output.!1+1# Prints 2 on the output![a for a in range(10)]# Prints list of values from 0 to 9 on the output!import os# Prints 'invalid syntax'. Such python operations are not allowed from the console due to security reasons
With game-console you can specify your own commands. For implementing new command called for example dummy that takes one parameter and prints it on the console in the blue color, you need to perform following steps:
- create a new python file
dummy.pyand place it toconsole_commandspackage (or other package specified by the consoleglobalconfiguration that can be changed) - see the existing example python files in the
console_commandspackage for reference.- The python file must contain
initializefunction (you can copy&paste it from example commmands). This function is called automatically when the command is first used. It manages registration of the command with the console. - The python file must contain also other function (with any name) that implements the command and is passed
game_ctx(reference to the game - same as when calling!game) and params (command parameters)
- The python file must contain
- It is good idea to return some value in case of failure. This is important if your custom command is part of some console script (read further).
There are already several custom functions implemented in the example game exit, move, and test. The move function takes 2 parameters delimited and changes position of the main game rectancle. The exit command exists the game. The list command shows information about registered commands.
All the non-python shell commands can be listed by typing help or simply ? on the command line. The example of generic command can be exit that simply quicks the game. Also by typing help move or simply ?move will list description of the command.
Python, Custom and Generic commands can be combined together into the file (one command on each line) and can be executed as a script.
Example of invoking such simple script is below:
script example1.scr
If there is an error on some line of the script, you are notified on the console with the error message - see below. The error code corresponds to the return value returned in the exception statement in the code of your custom function.
Console scripts also support parameters. See below the example using parameters for example3.scr script. Also, console script can be called from other console script.
script example3.scr x=100 y=200 color=128 name=MyBrick
The body of the script using those parameters is then looking as follows:
move $x $y
!print('I have moved the brick named $name')
!game.surf.fill((0, $color,0))
!print('I have colored the brick with $color')
!print("All done!")
The parameters are represented as keys starting with $ in the source of the console script.
As mentioned above, header or footer can display dynamic data. Those data are gained as a resulf of calling of some function of the main game class. In the example game, you will see time and game object position as some of the examples of such dynamic values.
If you want to have dynamic values in your console, you need to do the following:
- Implement functions that return the requested values in string time somewhere in your game class or alternativelly in some separate module. In case of our example game there are functions
cons_get_pos()andcons_get_time(). Check the code for details. - Specify the function in configuration json. See the folder
console_configsfor examples of different configurations. Also, see below parameterstextandtext_paramswhere the functions and its placement in the scrolling text is defined.
A mentioned in the list of features, console enables heavy configuration. I suggest you to see example console configs in the console_configs directory and get inspiration from 6 configurations that are predifined there.
Below you can see the pictures of those configurations in the game.
- Scrolling dynamic text in the header and footer
- Transparency of all console parts + wallpaper
- Animation upon displaying hidding of the console set to 2s
- Different fonts for different console parts
- Header and footer omitted by configuration
- Transparency of all console parts + wallpaper
- Animation upon displaying hidding of the console - from the bottom - default time 100ms
- Command line input is above console output part
- Different fonts for different console parts
- Totaly minimalistic - only header with dynamic text shown
- No transparency, no wallpapers
- Minimalistic - only header and footer with dynamic text shown
- No transparency, no wallpapers
- Header and footer are scrolling by different speed
- Minimalistic - only input and header with dynamic text shown
- No transparency, no wallpapers
- Minimalistic - only input and output with transparency
- Prepare configuration JSON. Use sample configuration dicts in
console_configsdirectory for inspiration - import Console class from pygame_console package and instantiate it
- For switching console on/off call
toggle()function - For reading the input keys and process them by console call
update()function - For showing the console use
show()function. Animation effect is processed internally.
