Themes¶
Installation¶
- Extract the new theme
- move the theme’s folder into
data/themes/
.
Settings¶
- Name of the settings file: theme.ini
- Header section: [theme]
- Format: key = value
- Value types:
- int
- float
- hexcolor: hexadecimal number that starts with the # sign and has six digits (colors)
- boolean: True or False
- str
- comma-separated: comma-separated value list
- Fonts values:
- bigFont
- font
- loadingFont
- pauseFont
- scoreFont
- shadowFont
- songFont
- songListFont
- streakFont
- streakFont2
Game setup¶
Controller select screen¶
Key | Value type | Default value | Description |
---|---|---|---|
control_activate_x |
float | 0.645 | X position of the list of available controls |
control_activate_y |
float | 0.18 | Y position of the list of available controls |
control_activate_scale |
float | 0.0018 | Size of the available control text |
control_activate_select_x |
float | 0.5 | X position of the select image on the list of available controls |
control_activate_part_x |
float | 0.41 | X position of the part images shown on the list of available controls |
control_activate_part_size |
float | 22.0 | Width (in rendered pixels) of the part images on the list of available controls |
control_activate_space |
float | 0.045 | Space between each available control |
control_activate_font |
str | font | The available controller font |
control_description_x |
float | 0.5 | X position of the information text |
control_description_y |
float | 0.13 | Y position of the information text |
control_description_scale |
float | 0.002 | Size of the information text |
control_description_font |
str | font | The information text font |
control_check_x |
float | 0.16 | X position of the first confirmed control |
control_check_y |
float | 0.26 | Y position of the first confirmed control |
control_check_text_y |
float | 0.61 | Y position of names of confirmed controls |
control_check_part_mult |
float | 2.8 | Number of times larger than control_activate_part_size confirmed parts should be |
control_check_space |
float | 0.23 | Amount of space between each confirmed controller |
control_check_scale |
float | 0.0018 | Size of names of confirmed controls |
control_check_font |
str | font | Font of names of confirmed controls |
Player lobby¶
Key | Value type | Default value | Description |
---|---|---|---|
lobby_mode |
int | 0 | Lobby mode |
lobby_font_color |
hexcolor | #FFFFFF | Color of player names |
lobby_select_color |
hexcolor | #FFBF00 | Color of the name of the selected player (if not using a select image |
lobby_disable_color |
hexcolor | #666666 | Color of already-selected player names |
lobby_info_color |
hexcolor | #FFFFFF | Color of the information text about the currently-selected player |
lobby_select_x |
float | 0.9 | X position of the player list |
lobby_select_y |
float | 0.32 | Y position of the player list |
lobby_select_scale |
float | 0.0018 | Size of the player list font |
lobby_select_font |
str | loadingFont | Font of the player list |
lobby_select_space |
float | 0.04 | Space between names in the player list |
lobby_select_length |
int | 5 | Number of items to show at a time in the player list |
lobby_preview_x |
float | 0.3 | X position of the selected player’s preview info |
lobby_preview_y |
float | 0.0 | Y offset of the selected player’s preview info |
lobby_preview_spacing |
float | 0.04 | Space between lines in the selected player’s preview info |
lobby_avatar_x |
float | 0.7 | (Lobby mode 1) X position of the selected player’s avatar |
lobby_avatar_y |
float | 0.75 | (Lobby mode 1) Y position of the selected player’s avatar |
lobby_avatar_scale |
float | 1.0 | (Lobby mode 1) Size of the selected player’s avatar |
lobby_select_image_x |
float | 0.8 | X position of the image behind the selected item, if available |
lobby_select_image_y |
float | 0.355 | Y position of the image behind the selected item, if available |
lobby_title_x |
float | 0.5 | X position of the “Choose Your Character” text / image |
lobby_title_y |
float | 0.24 | Y position of the “Choose Your Character” text / image |
lobby_title_character_x |
float | 0.26 | X position of the “Player #” text |
lobby_title_character_y |
float | 0.24 | Y position of the “Player #” text |
lobby_title_scale |
float | 0.0024 | Size of the title font |
lobby_title_color |
hexcolor | #FFFFFF | Color of the “Choose Your Character” text, if not using an image |
lobby_player_color |
hexcolor | #FFFFFF | Color of the “Player #” text |
lobby_title_font |
str | font | Font of the title text |
lobby_mode
values:- 0: locked avatar
- 1: floating avatar
Player creation¶
Key | Value type | Default value | Description |
---|---|---|---|
character_create_font_color |
hexcolor | #FFFFFF | Color of the menu options |
character_create_select_color |
hexcolor | #FFBF00 | Color of the currently-selected menu item |
character_create_help_color |
hexcolor | #FFFFFF | Color of the menu option help information |
character_create_help_y |
float | .73 | Y position of the menu option help information |
character_create_x |
float | 0.25 | X position of menu option names |
character_create_option_x |
float | 0.75 | X position of selectable option values |
character_create_y |
float | 0.15 | Y position of the first menu item |
character_create_scale |
float | .0018 | Size of the text |
character_create_space |
float | .045 | Space between menu items |
avatar_select_text_x |
float | .44 | X position of the “Choose Your Avatar” text |
avatar_select_text_y |
float | .16 | Y position of the “Choose Your Avatar” text |
avatar_select_text_scale |
float | .0027 | Size of the “Choose Your Avatar” text |
avatar_select_font |
str | font | Font used for the “Choose Your Avatar” text |
avatar_select_wheel_y |
float | 0.0 | Y offset of the avatar choice wheel |
avatar_select_avatar_x |
float | .667 | X position of the currently-selected avatar |
avatar_select_avatar_y |
float | .5 | Y position of the currently-selected avatar |
Song selection list / CD list¶
Key | Value type | Default value | Description |
---|---|---|---|
artist_selected_color |
hexcolor | #4080FF | Selected artist color |
artist_text_color |
hexcolor | #4080FF | Artist text color |
career_title_color |
hexcolor | #000000 | Career title color |
library_selected_color |
hexcolor | #FFBF00 | Selected library color |
library_text_color |
hexcolor | #FFFFFF | Library text color |
setlistguidebuttonsposx |
float | .408 | Setlist guide buttons image ‘X’ position |
setlistguidebuttonsposy |
float | .0322 | Setlist guide buttons image ‘Y’ position |
setlistguidebuttonsscalex |
float | .29 | Setlist guide buttons image scaling of ‘X’ size |
setlistguidebuttonsscaley |
float | .308 | Setlist guide buttons image scaling of ‘Y’ size |
setlistpreviewbuttonposx |
float | .5 | Preview buttons X position |
setlistpreviewbuttonposy |
float | .5 | Preview buttons Y position |
setlistpreviewbuttonscalex |
float | .5 | Preview buttons scaling of ‘X’ size |
setlistpreviewbuttonscaley |
float | .5 | Preview buttons scaling of ‘Y’ size |
song_cd_x |
int | 0 | X position of the CD |
song_cdscore_x |
float | .6 | X position of the CD score |
song_list_display |
int | 1 | Sets the songlist view |
song_list_x |
float | .15 | X position of the list |
song_listcd_cd_x |
float | ‘CD’ X position in listcd songlist view | |
song_listcd_cd_y |
float | ‘CD’ Y position in listcd songlist view | |
song_listcd_list_x |
float | ‘LIST’ X position in listcd songlist view | |
song_listcd_score_x |
float | ‘SCORE’ X position in listcd songlist view | |
song_listcd_score_y |
float | ‘SCORE’ Y position in listcd songlist view | |
song_listscore_x |
float | .8 | X position of the list score |
song_name_selected_color |
hexcolor | #FFBF00 | Selected song name color |
song_name_text_color |
hexcolor | #FFFFFF | Text song name color |
song_rb2_artist_color |
hexcolor | Color of the Rock Band 2 artist name | |
song_rb2_diff_color |
hexcolor | Color of the Rock Band 2 Difficulty level name | |
song_rb2_name_color |
hexcolor | Color of the Rock Band name | |
song_rb2_name_selected_color |
hexcolor | Color of the Rock Band 2 selected name | |
songback |
boolean | True | Scroll the song selection background image. If your image isn’t long enough, use SongChooseBack.png just in case, this image is static |
songlist_score_color |
hexcolor | #FFFFFF | Color of the song list score |
songlistcd_score_color |
hexcolor | Scores color for both CD and List / CD mode |
- Positions should be between 0 and 1
song_cd_x
values: between 0 and 5song_list_display
values:- 0: CD / Cassettes
- 1: list
- 2: list / CD
- 3: RB2
- 4: Auto (should not be used)
Difficulty, intruments, practice select screen¶
Key | Value type | Default value | Description |
---|---|---|---|
song_select_submenu_x |
float | 0 | X position of the submenu text |
song_select_submenu_y |
float | 0 | Y position of the submenu text |
song_select_submenu_offset_lines |
int | 2 | Add offset lines: has no effect if song_select_submenu_x and song_select_submenu_y aren’t used |
song_select_submenu_offset_spaces |
int | 2 | Add offset lines: has no effect if song_select_submenu_x and song_select_submenu_y aren’t used |
Loading phrase screen¶
Key | Value type | Default value | Description |
---|---|---|---|
loading_font_scale |
float | 0.0015 | Loading phrase font scale |
loading_line_spacinge |
float | 1.0 | Amount of line spacing. Default is 1 if not used |
loading_phrase |
str | How good are You? | Put an underscore between each phrase for multiple phrases |
loading_right_margin |
float | 1.0 | X offset from right side of the screen |
loading_text_color |
hexcolor | #FFFFFF | Loading phrase color |
loading_X |
float | .5 | X position of phrase |
loading_Y |
float | .595 | Y position of phrase |
shadowoffsetx |
float | .0022 | X offset to the loading screen font’s shadow |
shadowoffsety |
float | .0005 | Y offset to the loading screen font’s shadow |
In game¶
All instruments¶
Key | Value type | Default value | Description |
---|---|---|---|
display_all_grey_stars |
boolean | True | True: all 5 stars shown at all times. False:Ooly shows the grey star your currently working on |
ingame_stats_color |
hexcolor | #000000 | Color for the In Game stats |
song_info_display_scale |
float | 0.0020 | Size of the song info shown at gameplay countdown |
song_info_display_X |
float | 0.05 | X position of song info display during countdown |
song_info_display_Y |
float | 0.05 | Y position of song info display during countdown |
star_fillup_center_x |
int | 139 | X position of the center of the Star Fillup |
star_fillup_center_y |
int | 151 | Y position of the center of the Star Fillup |
star_fillup_in_radius |
int | 121 | Inner radius |
star_fillup_out_radius |
int | 138 | Outer radius |
star_fillup_color |
hexcolor | #FFF25E | Color of the star fill up |
Guitars and drums¶
Key | Value type | Default value | Description |
---|---|---|---|
fret0_color |
hexcolor | #22FF22 | Color for the 1st fret tail |
fret1_color |
hexcolor | #FF2222 | Color for the 2nd fret tail |
fret2_color |
hexcolor | #FFFF22 | Color for the 3rd fret tail |
fret3_color |
hexcolor | #3333FF | Color for the 4th fret tail |
fret4_color |
hexcolor | #FF9933 | Color for the 5th fret tail |
fretS_color |
hexcolor | #4CB2E5 | Color for all tails and notes when StarPower is active |
fretK_color |
hexcolor | #000000 | Color for the killswitch tail FX (#000000: FX is disabled) |
hopo_color |
hexcolor | #EEEEEE | Color for HO/PO |
hopo_indicator_active_color |
hexcolor | #0000FF | Active color of HO/PO indicator |
hopo_indicator_inactive_color |
hexcolor | #FF0000 | Inactive color of HO/PO indicator |
hopo_indicator_x |
float | .950 | X position of HOPO indicator |
hopo_indicator_y |
float | .950 | Y position of HOPO indicator |
jurgen_text_pos |
comma-separated float | 1,1,0.0004 | Jurgen text position : scale, X position, Y position |
mesh_color |
hexcolor | #000000 | Color of the mesh |
neck_width |
int | 3 | Width of the fret board |
neck_length |
int | 9 | Length of the fret board to be |
obar_hscale |
float | 0.7 | Overdrive bar width scale |
obar_3dfill |
boolean | False | Use perspective for overdrive_fill.png |
opencolor |
hexcolor | #FF8000 | Color of the Bass drum note for 3d notes |
pov_target_x |
float | 0.0 | Point of view X target |
pov_target_y |
float | 0.0 | Point of view Y target |
pov_target_z |
float | 3.7 | Point of view Z target |
pov_origin_x |
float | 0.0 | Point of view X origin |
pov_origin_y |
float | 2.9 | Point of view Y origin |
pov_origin_z |
float | -2.9 | Point of view Z origin |
rbmenu |
boolean | True | Turns on replicating the buttons scrolling up from the bottom at the game intro for Rock Band theme’s |
rockmeter_score_color |
hexcolor | #93c351 | Color for the rockmeter score |
Rotating 3d Starnotes |
str | on | On / off |
spot_color |
hexcolor | #EEEEEE | Color of the spot |
threeDspin |
boolean | False | Turns 3d Starnote spinning off |
twoDkeys |
boolean | False | Use 2d / 3d keys |
twoDnote |
boolean | False | Use 2d / 3d notes |
noterotdegrees |
int | 2 | Degree to use for rotating the notes (textured 3d notes only) |
noterot1 |
int | -2 | Number of applied rotation degree to the 1st note (textured 3d notes only) |
noterot2 |
int | -1 | Number of applied rotation degree to the 2nd note (textured 3d notes only) |
noterot3 |
int | 0 | Number of applied rotation degree to the 3rd note (textured 3d notes only) |
noterot4 |
int | 1 | Number of applied rotation degree to the 4th note (textured 3d notes only) |
noterot5 |
int | 2 | Number of applied rotation degree to the 5th note (textured 3d notes only) |
Vocals¶
Not implemented yet
Key | Value type | Default value | Description |
---|---|---|---|
vocal_meter_size |
float | 45.000 | |
vocal_meter_x |
float | .25 | |
vocal_meter_y |
float | .8 | |
vocal_mult_x |
float | .28 | |
vocal_mult_y |
float | .8 | |
vocal_power_x |
float | .5 | |
vocal_power_y |
float | .5 | |
vocal_fillup_center_x |
int | 139 | |
vocal_fillup_center_y |
int | 151 | |
vocal_fillup_in_radius |
int | 25 | |
vocal_fillup_out_radius |
int | 139 | |
vocal_fillup_color |
hexcolor | #DFDFDE | |
vocal_fillup_factor |
float | 300.000 | |
vocal_circular_fillup |
boolean | True | |
vocal_lane_size |
float | .002 | |
vocal_glow_size |
float | .012 | |
vocal_glow_fade |
float | .6 | |
vocal_lane_color |
hexcolor | #99FF80 | |
vocal_shadow_color |
hexcolor | #CCFFBF | |
vocal_glow_color |
hexcolor | #33FF00 | |
vocal_lane_color_star |
hexcolor | #FFFF80 | |
vocal_shadow_color_star |
hexcolor | #FFFFBF | |
vocal_glow_color_star |
hexcolor | #FFFF00 |
Game result screen¶
Key | Value type | Default value | Description |
---|---|---|---|
crowd_loop_delay |
integer | 550 | User setting for sounds/crowdcheers.ogg |
result_cheats_color |
hexcolor | #FFFFFF | Color of results cheats |
result_cheats_info |
comma-separated float | .5, .3, .002 | X, Y positions and size of results cheats info |
result_cheats_numbers |
comma-separated float | .5, .35, .0015 | X, Y positions and size of results cheats numbers |
result_cheats_percent |
comma-separated float | .45, .4, .0015 | X, Y positions and size of the results cheats percent |
result_cheats_score |
comma-separated float | .75, .4, .0015 | X, Y positions and size of the results cheats score |
result_menu_x |
float | .210 | X position of the ‘final text’ on the results screen |
result_menu_y |
float | .210 | Y position of the ‘final text’ on the results screen |
result_score |
comma-separated float | .5, .11, 0.0025 | X, Y positions of the results score |
result_song |
comma-separated float | .05, .045, .002, #FFFFFF | X, Y positions of the song name |
result_song_text |
str | %s Finished! | %s is for the song name |
result_star |
comma-separated float | .5, .4, 0.15, 1.1 | X, Y positions, scaling of the stars and space between stars |
result_stats_accuracy |
comma-separated float | .5, .61, 0.002, #FFFFFF | X, Y positions of the accuracy % value |
result_stats_accuracy_text |
str | Accuracy: %.1f%% | Accuracy in % |
result_stats_diff |
comma-separated float | .5, .55, 0.002, #FFFFFF | X, Y positions of the difficulty stats |
result_stats_diff_text |
str | Difficulty: %s | Difficulty text |
result_stats_notes |
comma-separated float | .5, .52, 0.002, #FFFFFF | X, Y positions of the notes hit value |
result_stats_notes_text |
str | %s Notes Hit | Number of hits |
result_stats_part |
comma-separated float | .5, .64, 0.002, #FFFFFF | X, Y positions of the results part |
result_stats_part_text |
str | Part: %s | Part of the song |
result_stats_streak |
comma-separated float | .5, .58, 0.002, #FFFFFF | X, Y positions of the streak value |
result_stats_streak_text |
str | Longest Streak: %s | Number of longest streak |