Create an Asset Pack - TheXTech/TheXTech GitHub Wiki

[This page is working in progress]

Asset Packs are Graphics, Musics, Sound Effects, or anything-related object files (includes scripts in the future) for TheXTech.

Notes

  • This page might need to be rewritten after Lua script system support.
  • TheXTech engine is currently made for playing past works (e.g. Episodes and Levels that created with legacy SMBX 1.3). This means, it's not intended for creating sandbox game asset packs right now; You can still create them, but they can only be simple cosmetic changes of SMBX 1.3 objects (e.g. Graphics, Music, SFX, etc.) by current.
  • New gameplay features should being to Asset Pack instead of the core engine, but it's unknown that is it doable with Lua Script System or not, therefore it's not advised to make conjectruals. You have to use other tools/engines, such as SMBX2, LÖVE, etc. for Lua experiments. For more issues about Lua, see Here.

Read Before Creating

  • TheXTech is a SMBX64-hybrid engine, see their respective documentation for more info. It's also a project that used by researching of Moondust Project.
  • For non-SMBX64 (unique) asset packs, you can mark some of the objects as "Unused".
  • Due to TheXTech feature limitation, it's impossible to create a unique asset pack with complete gameplay features right now. Since Moondust Engine is in WIP stage, you are required to use other engines instead for non-SMBX64 custom objects, but they're level/episode specific.
  • You can use dummy slots as well, but it's better to use them after Lua script system support in the future.
  • End of Line Characters should be LF in .ini files. CRLF can be used as well.
  • It's NOT recommended to enable LunaScript engine for sandbox game asset packs.

Structure

Game Asset Settings

  • .nomedia - Prevent to detect media files in the game asset. Without this file, on Android, the gallery will be flooded by in-game graphics.
  • editor.ini - Game Editor Settings / Arrangements
  • gameinfo.ini - Game Asset Settings
  • Intro/Title Level ["introset" folder that contains many different levels inside (level will be selected randomly), or one intro.lvl(x) at the game root]
  • Outro/Credits Level [outro.lvl(x)]
  • thextech.ini - A special file that need to be forced portable. It should contain next text:
[Main]
force-portable = true
  • music.ini - Asset-global Music List
  • sounds.ini - Asset-global Sound Effect List to be pre-loaded. This affects load time and RAM, so more Asset-global SFX should be handled via Lua script system in the future.

graphics

Level

  • Backgrounds (a.k.a. BGP) (background2) - Total 58
  • Background Objects (a.k.a. Decoration) (background) - Total 200
  • Blocks (block) - Total 700
  • Effects (effect) - Total 148
  • NPC's (Includes Enemies, Objects and NPC's) (npc) - Total 300

World Map

  • Terrain Tiles (tile) - Total 400
  • Sceneries (scene) - Total 100
  • Path Tiles (path) - Total 100
  • Level Tiles (level) - Total 100

Characters

  • Number 1 (mario) - Effect #3 for death
  • Number 2 (luigi) - Effect #5 for death
  • Number 3 (peach) - Effect #129 for death
  • Number 4 (toad) - Effect #130 for death
  • Number 5 (link) - Effect #134 for death (Bidirectional)
  • Horse Vehicle (yoshi) - 8 colours
  • Map (player)

Supports player caliboration files since 1.3.3. You cannot customize the animation or change grab position, so please think carefully with custom characters. Any character that require custom animations cannot be used.

Graphical User Interface

  • User Interface (ui)
  • On-screen Controls (touchscreen)

fonts

Font files (Bitmap and TTF) and it's config.

languages

Language files. Original strings should be translated by using Weblate platform, but you can also change partial strings (Includes general strings) to fit the current asset.

music

There're 56 musics SMBX64 Standard. More game musics can be added.

sound

Asset-global Sound Effects, can either be pre-loaded or not.There're 104 (102 on Main SMBX Asset) sound effects to be pre-loaded in TheXTech engine. New sound effects maybe able to put in after Lua system support.

worlds

Episodes that need to put in this folder.

battle

Levels that exclusive to 2-Player Battle Game.

See the simple description of each object of TheXTech.