Difference between revisions of "config.xml"

From Frankfurt STK Wiki
Jump to navigation Jump to search
m
 
Line 9: Line 9:
 
The file located on <code>/storage/emulated/0/Android/data/org.supertuxkart.stk/files/supertuxkart/home/supertuxkart/config-0.10/config.xml</code>.
 
The file located on <code>/storage/emulated/0/Android/data/org.supertuxkart.stk/files/supertuxkart/home/supertuxkart/config-0.10/config.xml</code>.
  
Do note that on Android 11, you will need a Storage Access Framework capable file manager like [https://forum.xda-developers.com/t/app-2-2-mixplorer-v6-x-released-fully-featured-file-manager.1523691/ MiXplorer] to be able to access the file. If you are on Android 12 or above, unfortunately they have patched the SAF workaround and thus will require ADB or root access.
+
Do note that on Android 11, you will need a Storage Access Framework capable file manager like [https://forum.xda-developers.com/t/app-2-2-mixplorer-v6-x-released-fully-featured-file-manager.1523691/ MiXplorer] to be able to access the file.
  
If you're running on Android 10 or below, you can access it without a problem.
+
If you're running on Android 10 or below, you can access it without any restrictions.
  
 
=== Linux ===
 
=== Linux ===

Latest revision as of 05:06, 20 December 2023

config.xml is a SuperTuxKart configuration file that stores user settings. It is not to be confused with stk_config.xml.

config.xml contains lots of hidden settings that are otherwise not accessible in the Options screen. Which can sometimes be useful in some scenarios.

Location

Android

The file located on /storage/emulated/0/Android/data/org.supertuxkart.stk/files/supertuxkart/home/supertuxkart/config-0.10/config.xml.

Do note that on Android 11, you will need a Storage Access Framework capable file manager like MiXplorer to be able to access the file.

If you're running on Android 10 or below, you can access it without any restrictions.

Linux

The file is located on /home/your username/.config/supertuxkart/config-0.10/config.xml.

macOS

The file is located on /Users/your username/Library/Application Support/supertuxkart/config-0.10/config.xml.

Windows

The file is located on C:\Users\your username\AppData\Roaming\supertuxkart\config-0.10\config.xml.

iOS

You must Jailbreak(?) your device in order to access and edit config.xml. It will not be covered here.

Parameters

  • kart - The last kart that was selected by id. For example, addon_kiki
  • last_kart_group - The last kart group that was selected. For example, Add-ons
  • additional_gp_directory - Additional directories to use for SuperTuxKart to search for Grand Prix files. For example, if you want to include your Grand Prix files from your USB, add /media/user/USB
  • server-bookmarks - Where your server bookmarks are stored.
  • address-history - Stores your last visited servers when you enter it in the server address.
  • ipv4-stun-servers - IPv4 Stun addresses to use. Defaults are: (do not click)
    • stunv4.7.supertuxkart.net:3478
    • stunv4.8.supertuxkart.net:3478
    • stunv4.linuxreviews.org:3478
  • ipv6-stun-servers - IPv6 Stun addresses to use. Defaults are: (do not click)
    • stun.supertuxkart.net:3478
    • stun.stunprotocol.org:3478
    • stun.linuxreviews.org:3478
  • num-karts-per-gamemode - Determines number of karts in each gamemode.
  • cache-overworld - Unknown.
  • crashed - Determines if SuperTuxKart crashed?
  • camera-normal - Settings for the Normal Camera.
  • standard-camera-settings - Settings for the standard camera.
  • drone-camera-settings - Settings for the Drone Chase camera.
  • saved-camera-settings - Custom Camera settings.
  • camera - Camera settings.
  • item_style - Unknown.
  • last_track - The last track that was used by id. If the player never used a track yet, it defaults to olivermath or Oliver's Math Class.
  • last_track_group - The last track group that was used. For example, standard.
  • discord_client_id - Discord Client ID used to make the Discord Rich Presence work when playing SuperTuxKart. Defaults to 817760324983324753.
  • rich_presence_debug - Whether to debug the Rich Presence feature.
  • skin_name - Name of the skin to use.
  • enable_internet - Whether to enable Internet connectivity
    • 0 - User wasn't asked
    • 1 - Enabled
    • 2 - Disabled
  • language - Language to use in language code. Or use system to auto-detect your language id. If a language that SuperTuxKart doesn't know is detected (for example, fil_PH for Filipino), it falls back to English (United States).
  • artist_debug_mode - Whether to enable Artist Debug Mode.
  • debug_hide_gui - Whether to hide the GUI (requires Artist Debug Mode to be enabled.)
  • unlock_everything - Whether to unlock every single track or kart that is locked.
    • 0 - disabled
    • 1 - everything except final race
    • 2 - everything
  • commandline - Command Line arguments to add when staring STK. Note that some arguments that you'd expect will not work in this setting.

Audio

  • sfx_on - Determines whether sound effects is turned on or off. 0 = off, 1 = on
  • music_on - Determines whether music is turned on or off. 0 = off, 1 = on
  • sfx_volume - Volume of sound effects from 0 to 10 in decimals. For example, 0.7 = level 7, 1 = level 10
  • music_volume - Volume of music from 0 to 10 in decimals.

RaceSetup

  • numkarts - Number of Karts. Must not be lower than 0 or higher than 19
  • numlaps - Number of Laps. Must not be lower than 0 or higher than 20
  • ffa-time-limit - Free-For-All time limit in minutes
  • numgoals - Number of goals in Soccer.
  • soccer-default-team - Default team to use in Soccer. 0 = Red, 1 = Blue
  • soccer-time-limit - Soccer time limit in minutes. Must not exceed 20.
  • soccer-use-time-limit - Whether to enable the Time Limit for Soccer or not.
  • random-arena-item - Whether to enable random item location for Soccer and Battle.
  • difficulty - The game difficulty used.
    • 0 - Novice
    • 1 - Intermediate
    • 2 - Expert
    • 3 - SuperTux
  • game_mode - The game mode previously selected.
  • soccer-red-ai-num - Number of red AI karts in Soccer
  • soccer-blue-ai-num - Number of blue AI karts in Soccer
  • addon-tux-online - Show addon karts as Tux online.
  • random-player-pos - Randomize player position when starting a race. Does not apply in Story Mode.

Wiimote

TODO: Add section

Multitouch

  • multitouch_active - Enable touch support
    • 0 - disabled
    • 1 - if available
    • 2 - enabled
  • multitouch_draw_gui - Enables the touch GUI
  • multitouch_inverted - Invert GUI order. For example, the steering wheel goes to the left and the controls go to the right.
  • multitouch_auto_acceleration - Whether to enable auto acceleration for steering wheel.
  • multitouch_controls - Determines the type of touch control the user wants.
    • 0 - undefined
    • 1 - steering wheel
    • 2 - accelerometer
    • 3 - gyroscope
  • multitouch_dead_zone - Unknown.
  • multitouch_sensitivity_x - Sensitivity for the X axis.
  • multitouch_sensitivity_y - Sensitivity for the Y axis.
  • multitouch_tilt_factor - Determines accelerometer sensitivity.
  • multitouch_scale - Size of buttons in the screen.
  • screen_keyboard_status - Whether to enable the on-screen keyboard or not. Useful for non-Android/iOS devices.

GpStartOrder

  • most_points_first - Whether to put the player with the most points in front of the starting lane.
  • player_last - Always put the player at the back of the starting lane. (Also known as "Bully mode")

Video

TODO: Add section

Recording

  • limit_game_fps - Determines if the FPS should be limited.
  • video_format - Unknown. But 0 means to save the video in webm.
  • audio_bitrate - Specifies the audio bitrate.
  • video_bitrate - Specifies the video bitrate.
  • recorder_jpg_quality - Specifies the jpg compression level for the recorder.
  • record_fps - The framerate of the video recording. Also is the frame limiter value.

Network

  • enable-network-splitscreen - Whether to enable the online multiplayer splitscreen.
  • log-network-packets - Whether to monitor the network packets.
  • random-client-port - Whether to randomize the client port.
  • random-server-port - Whether to randomize the server port.
  • lobby-chat - Whether to enable chatting online.
  • race-chat - Whether to enable the chat while in-game (racing, etc.)
  • ipv6-lan - Whether to enable IPv6 LAN discovery.
  • max-players - Determines the max players when creating a server.
  • timer-sync-difference-tolerance - Unknown.
  • default-ip-type - Determines the default IP type to use.
    • 0 - IPv4
    • 1 - IPv6
  • lan-server-gp - Show Grand Prix as an option in the create LAN server screen. If this is set to false, then the AI option shows up.
  • wan-server-gp - Show Grand Prix as an option in the create WAN server screen. If this is set to false, then the AI option shows up.

GFX

  • particles-effecs - Whether to enable particle effects.
    • 0 - Disabled
    • 1 - Important Only
    • 2 - Enabled
  • christmas-mode - Whether to enable the Christmas hats for karts.
    • 0 - use current date (if the month is December)
    • 1 - always on
    • 2 - always off (do not show christmas hats regardless of date)
  • easter-ear-mode - Whether to enable the Easter Bunny ears for karts.
    • 0 - use current date (if the month is April)
    • 1 - always on
    • 2 - always off (do not show Easter Bunny ears regardless of date)
  • animated-characters - Whether to enable kart animations/moving parts (example, tail) or not.
  • geometry_level - Level of cosmetic details
    • 0 - show everything
    • 1 - show only few details
    • 2 - disabled
  • anisotropic - Quality of anisotropic filtering.
  • swap-interval - VSync swap interval.
    • 0 - disabled
    • 1 -full
  • motionblur_enabled - Whether motion blur should be enabled.
  • mlaa - Whether MLAA anti-aliasing should be enabled.
  • ssao - Whether to enable Screen Space Ambient Occlusion
  • light_scatter - Whether to enable light scattering.
  • shadows_resolution - Shadow Resolution.
  • Degraded_IBL - Disable specular IBL

Minimap

  • display - Position of the minimap.
    • 0 - Bottom Left
    • 1 - Middle Right
    • 2 - Hidden
    • 3 - Centered
  • size - Size of the minimap.
  • ai-icon - Size of the icon of an AI player.
  • player-icon - Size of the player icon.

PowerUp

  • display - Whether to see the karts' held powerups.
    • 0 - Center
    • 1 - Right Side
    • 2 - Hidden

Spectator

  • camera-distance - Distance between the kart and the camera.
  • camera-angle - Angle between the ground, kart, and camera.

Handicap

  • per_player_difficulty - If handicapped users can be selected.

HWReport

  • report-version - Hardware Report Version
  • random-identifier - Random number to be set to avoid duplicate reports.
  • hw-report-enabled - Whether to enable Hardware Reports. (Telemetry)

AddonServer

  • news_last_updated - When the news was last updated. (In Unix Epoch Time)
  • news_frequency - How often the news should be updated.
  • news_display_count - Unknown.
  • last_important_message_id - Unknown. Value is -1.
  • addon_last_updated - Time when the addon list was updated. (In Unix Epoch Time)
  • latest_addon_time - Time when the latest approved addon was added. (In Unix Epoch Time)