Once your module is complete, you'll want to upload it to http://te4.org/games so that others can play it. To do so:

<ol>
<li>Request upload permission from http://te4.org/contact, if you haven't already done so.</li>
<li> Go to http://te4.org and click the "Create a module" link. Fill out the form there; most of the information here can come straight out of your [[Getting_Started#init.lua|init.lua]].</li>
<li>Zip your module up into a <code>.team</code> file. A <code>.team</code> file is simply a zip file, renamed to have a <code>.team</code> extension. The <code>.team</code> file's layout is slightly different than the normal [[Directory_Structure|module directory structure]]; the <code>data</code> subdirectory remains unchanged, while everything else is placed in a <code>mod</code> subdirectory. (You'll probably also want to exclude any development documentation, .gitignore files, scripts, etc.)</li>
<li>Get the MD5 checksum for your module. To do so, start ToME, load your newly zipped module, then exit. Check <code>te4_log.txt</code> for a line similar to the following:
<pre>[MODULE LOADER] module MD5 1234567890abcdef1234567890abcdef</pre>
In this example, "1234567890abcdef1234567890abcdef" is the checksum.</li>
<li>Go to http://te4.org and click the "Upload a module" link. Under "File:", select your <code>.team</code> file and click Upload. Fill out the rest of the page and click Save.</li>
<li>Go to http://te4.org/games and bask in the pleasure of seeing it listed alongside the other T-Engine4 games. Dream about it becoming the next smash hit.
</ol>

A script to automate creating the .team file and calculating the MD5 checksum is available at https://github.com/joshkel/qdz/blob/master/dev/release.py. Although it was written for another T-Engine module, it should work with any module. Just run it from the command line with the path to your module directory as a command-line parameter. (You'll need to have Python 2.7 or 3 installed.)

Uploading a module

2013-09-16T02:21:32Z

Castler: Created page with "Once your module is complete, you'll want to upload it to http://te4.org/games so that others can play it. To do so: <ol> <li>Request upload permission from http://te4.org/c..."

T4 Modules Howto Guide

2013-09-16T02:00:59Z

Castler:

How to start making a module for the T-Engine 4:
----
*[[Getting Started]]
*[[Directory Structure]]
*[[Engine Structure]]
*[[Player Descriptors]]
*[[T4 Modules Howto Guide/Talents|Talents]]
*[[Entities]]
*[[T4 Modules Howto Guide/Zones|Zones]]
*[[NPCs]]
*[[Objects]]
*[[Inventory Dialogs]]
*[[T4 Modules Howto Guide/Traps|Traps]] (not created)
*[[Dialogs]]
*[[Character Sheet Dialogs]]
*[[T4 Modules Howto Guide/Stores|Stores]] (not created)
*[[Factions]]
*[[T4 Modules Howto Guide/Quests|Quests]] (not created)
*[[Chats]]
*[[Frame Buffers]]
*[[Developing a static map using the Tiled plugin]]
*[[T4 Modules Howto Guide/Resolvers|Resolvers]] (not created)
*[[Particle Effects]]
*[[Uploading a module]]

2013-05-31T23:05:42Z

Castler: /* Output log text to file immediately */

=== Debugging: Figuring out what went wrong ===

==== Updating your configuration ====
Enabling cheat/development mode will grant you access to the internal Lua console and some additional dialogs/options useful for debugging. It will stop you from uploading characters online, though, but you can always turn this mode off.

<ul>
<li>Navigate to the corresponding configuration directory (replace HOME with your home directory).

{|
! Operating System !! Configuration Directory
|-
| Windows || HOME\T-Engine\4.0\settings
|-
| Linux || HOME/.t-egine/4.0/settings
|-
| Mac OSX || HOME\Library\Application Support\T-Engine\4.0\settings
|}
</li>
<li>Create a file called ''cheat.cfg'' in that directory, and put the following text in that file.
<pre>
cheat = true
</pre>
<li>
To turn cheat/development mode off, just change ''true'' to ''false'' or delete the ''cheat.cfg'' file.
</li>
</ul>

==== Inside of ToME ====
{|
! Key Shortcut !! Result
|-
| Ctrl+L || Lua console
|-
| Ctrl+A || Debug dialog
|-
| Ctrl+S || save the game
|-
| Ctrl+alt+shift+r || Reload the last save
|}
NOTE: The keybinding may not be set, in this case you have to bind it yourself first.

===== Lua console =====

Summary of features:
* Inspect values and execute code
* Cursor positioning
* Tab auto-completion
* Copy and paste with system clipboard

The Lua console drops you into the global namespace and gives you access to [[t4modules engine structure|the engine]]. If you want to inspect values, start the line with an equal sign. For example, say you want to inspect the player:

<code>
=game.player
</code>

The console has cursor positioning so you can use the Left and Right arrows, as well as Home and End to move to the beginning and end of the current line, respectively. You can paste the clipboard's contents to the cursor position with Ctrl+V (note, not Apple+V on Mac). The current line can be copied to the clipboard with Ctrl+C (again, not Apple+C).

Here are some useful commands to know.
If you want to get to level 50 use:
<code>
game.player:forceLevelup(50)
</code>
Remove godmode invulnerability:
<code>
game.player.invulnerable=0
</code>
Change your damage bonus:
<code>
game.player.inc_damage.all=
</code>
Change your resistance:
<code>
game.player.self.resists.all=
</code>
Learn a new talent (1 level in Slash in the example):
<code>
game.player:learnTalent(game.player.T_SLASH, true, 1)
</code>
Apply an effect on the player(frozen for 10 turns):
<code>
game.player:setEffect(game.player.EFF_FROZEN, 10, {})
</code>
Change your max HP:
<code>
game.player.max_life=1
</code>
<code>
game.player:resetToFull()
</code>
Teleport (to the Assassin Lord):
<code>
game:changeLevel(2,"thieves-tunnels")
</code>
Add 5000 gold:
<code>
game.player:incMoney(5000)
</code>
Give yourself 10 unassigned class skills:
<code>
game.player.unused_talents=10
</code>
Give yourself 10 unused stat points:
<code>
game.player.unused_stats=10
</code>
Give yourself an extra stat point each level: (default=3)
<code>
game.player.stats_per_level=4
</code>
Give yourself 10 unused generic points:
<code>
game.player.unused_generics=10
</code>
Give yourself 10 unused category points:
<code>
game.player.unused_talents_types=10
</code>
Give yourself 10 lives:
<code>
game.player.easy_mode_lifes=10
</code>

=== Output log text to file immediately ===

<ol>
<li>Create a shortcut to t-engine.exe.</li>
<li>Right-click the shortcut and select Properties.</li>
<li>Add the command to the end of the "Target" line:
<code>
--flush-stdout
</code>
</li>
</ol>

The end of the Target line should look like this then: <pre>\t-engine.exe --flush-stdout</pre>

This can be used in combination with a [http://en.wikipedia.org/wiki/Tail_(Unix) tail] program that shows the content of the log file in realtime.

=== Load Module and create Character on startup ===
[19:51:28] <DarkGod> : Hetdegon, you create a character once
[19:51:36] <DarkGod> : then you can use the premade from the command line:
[19:51:53] <DarkGod> : t-engine -Mtome -n -E"auto_quickbirth='player'"
[19:51:58] <DarkGod> : if your premade was named "player"

Debugging

2013-05-31T23:01:08Z

Castler: /* Updating your configuration */

=== Debugging: Figuring out what went wrong ===

==== Updating your configuration ====
Enabling cheat/development mode will grant you access to the internal Lua console and some additional dialogs/options useful for debugging. It will stop you from uploading characters online, though, but you can always turn this mode off.

<ul>
<li>Navigate to the corresponding configuration directory (replace HOME with your home directory).

{|
! Operating System !! Configuration Directory
|-
| Windows || HOME\T-Engine\4.0\settings
|-
| Linux || HOME/.t-egine/4.0/settings
|-
| Mac OSX || HOME\Library\Application Support\T-Engine\4.0\settings
|}
</li>
<li>Create a file called ''cheat.cfg'' in that directory, and put the following text in that file.
<pre>
cheat = true
</pre>
<li>
To turn cheat/development mode off, just change ''true'' to ''false'' or delete the ''cheat.cfg'' file.
</li>
</ul>

==== Inside of ToME ====
{|
! Key Shortcut !! Result
|-
| Ctrl+L || Lua console
|-
| Ctrl+A || Debug dialog
|-
| Ctrl+S || save the game
|-
| Ctrl+alt+shift+r || Reload the last save
|}
NOTE: The keybinding may not be set, in this case you have to bind it yourself first.

===== Lua console =====

Summary of features:
* Inspect values and execute code
* Cursor positioning
* Tab auto-completion
* Copy and paste with system clipboard

The Lua console drops you into the global namespace and gives you access to [[t4modules engine structure|the engine]]. If you want to inspect values, start the line with an equal sign. For example, say you want to inspect the player:

<code>
=game.player
</code>

The console has cursor positioning so you can use the Left and Right arrows, as well as Home and End to move to the beginning and end of the current line, respectively. You can paste the clipboard's contents to the cursor position with Ctrl+V (note, not Apple+V on Mac). The current line can be copied to the clipboard with Ctrl+C (again, not Apple+C).

Here are some useful commands to know.
If you want to get to level 50 use:
<code>
game.player:forceLevelup(50)
</code>
Remove godmode invulnerability:
<code>
game.player.invulnerable=0
</code>
Change your damage bonus:
<code>
game.player.inc_damage.all=
</code>
Change your resistance:
<code>
game.player.self.resists.all=
</code>
Learn a new talent (1 level in Slash in the example):
<code>
game.player:learnTalent(game.player.T_SLASH, true, 1)
</code>
Apply an effect on the player(frozen for 10 turns):
<code>
game.player:setEffect(game.player.EFF_FROZEN, 10, {})
</code>
Change your max HP:
<code>
game.player.max_life=1
</code>
<code>
game.player:resetToFull()
</code>
Teleport (to the Assassin Lord):
<code>
game:changeLevel(2,"thieves-tunnels")
</code>
Add 5000 gold:
<code>
game.player:incMoney(5000)
</code>
Give yourself 10 unassigned class skills:
<code>
game.player.unused_talents=10
</code>
Give yourself 10 unused stat points:
<code>
game.player.unused_stats=10
</code>
Give yourself an extra stat point each level: (default=3)
<code>
game.player.stats_per_level=4
</code>
Give yourself 10 unused generic points:
<code>
game.player.unused_generics=10
</code>
Give yourself 10 unused category points:
<code>
game.player.unused_talents_types=10
</code>
Give yourself 10 lives:
<code>
game.player.easy_mode_lifes=10
</code>

=== Windows and Mac: Output log text to file immediately ===
1) Create a shortcut to t-engine.exe
2) Rightclick the shortcut, select Properties
3) Add the command to the end of the "Target" line
<code>
--flush-stdout
</code>

The end of the Target line should look like this then: \t-engine.exe --flush-stdout

This can be used in combination with a Tail program that shows the content of the log file in realtime.

=== Load Module and create Character on startup ===
[19:51:28] <DarkGod> : Hetdegon, you create a character once
[19:51:36] <DarkGod> : then you can use the premade from the command line:
[19:51:53] <DarkGod> : t-engine -Mtome -n -E"auto_quickbirth='player'"
[19:51:58] <DarkGod> : if your premade was named "player"