Brazil: Created page with "= Inja Template Engine Integration = This project integrates the [https://github.com/pantor/inja inja] C++ template engine for dynamic text rendering in the MUD. Builders and developers can use inja templates to create flexible, data-driven descriptions and messages. == Features Exposed to Templates == === 1. Variable Substitution === You can use variables from the game context: * `player.name`, `player.level`, `player.race`, etc. *..."

2026-05-15T02:52:41Z

Created page with "= Inja Template Engine Integration = This project integrates the [https://github.com/pantor/inja inja] C++ template engine for dynamic text rendering in the MUD. Builders and developers can use inja templates to create flexible, data-driven descriptions and messages. == Features Exposed to Templates == === 1. Variable Substitution === You can use variables from the game context: * <code>player.name</code>, <code>player.level</code>, <code>player.race</code>, etc. *..."

New page

= Inja Template Engine Integration =

This project integrates the [https://github.com/pantor/inja inja] C++ template engine for dynamic text rendering in the MUD. Builders and developers can use inja templates to create flexible, data-driven descriptions and messages.

== Features Exposed to Templates ==

=== 1. Variable Substitution ===

You can use variables from the game context:

* <code>player.name</code>, <code>player.level</code>, <code>player.race</code>, etc.
* <code>room.name</code>, <code>room.vnum</code>, <code>room.sector</code>, <code>room.light</code>, <code>room.people_count</code>, etc.
* <code>time.hour</code>, <code>time.day</code>, <code>time.month</code>, <code>time.year</code>, <code>time.period</code> ("morning", "afternoon", "evening", "night")

'''Example:'''

<pre>
Welcome, {{ player.name }}! You are in the {{ room.name }}.
</pre>

=== 2. Conditionals ===

Use <code>{% if %}</code>, <code>{% else %}</code>, and <code>{% endif %}</code> for logic:

<pre>
{% if room.people_count > 0 %}
The room is occupied.
{% else %}
The room is empty.
{% endif %}
</pre>

=== 3. Loops ===

You can loop over arrays (if provided in context):

<pre>
{% for item in player.inventory %}
- {{ item }}
{% endfor %}
</pre>

=== 4. Random Sentence Selection ===

Use the custom <code>random_choice</code> callback to randomly select one string from an array:

<pre>
{{ random_choice(["A cold wind blows.", "You hear distant laughter.", "The torches flicker ominously."]) }}
</pre>

Each time the template is rendered, one of the options will be chosen at random.

=== 5. Line Breaks ===

Use the custom <code>br()</code> and <code>br2()</code> callbacks for single and double line breaks:

<pre>
Line one.{{ br() }}Line two.{{ br2() }}Line three.
</pre>

=== 6. Text Cleanup and Wrapping ===

Long lines are automatically wrapped and cleaned up according to game settings.

=== 7. Random Number Generation and Conditional Blocks ===

You can use the custom <code>number(min, max)</code> callback to generate a random integer between <code>min</code> and <code>max</code> (inclusive). This enables conditional logic in templates, such as randomizing which block of text is shown.

'''Example:'''

<pre>
{% set n = number(0, 100) %}
{% if n < 33 %}
The shadows seem to move.
{% elseif n < 66 %}
You hear a distant howl.
{% else %}
A sudden chill fills the air.
{% endif %}
</pre>

Each time the template is rendered, a different block may be selected based on the random number.

== Available Variables ==

=== Player ===

* <code>player.name</code> (string)
* <code>player.level</code> (int)
* <code>player.race</code> (string)
* <code>player.str</code>, <code>player.dex</code>, <code>player.wis</code>, <code>player.con</code>, <code>player.int</code>, <code>player.cha</code> (int)
* <code>player.height</code>, <code>player.weight</code> (int)
* <code>player.guild</code> (object, e.g. <code>player.guild.Warrior</code>)
** <code>player.guild</code> is a hash. If you were to display the value you would see all of your guild levels. A level of 0 means you aren't a member of that guild.
** Check specific guild levels directly: <code>player.guild.MindWarrior</code>.

Example:

<pre>
{
"AntiPaladin":0,
"Cleric":65,
"Crusader":0,
"DarkKnight":0,
"Hero":0,
"Immortal":30,
"Invisible":0,
"Knight":30,
"MindWarrior":0,
"NPC":0,
"Necromancer":0,
"Ninja":0,
"Paladin":0,
"Psionicist":30,
"Remort":0,
"Rogue":0,
"Scrollmaker":0,
"Sorcerer":0,
"Thief":1,
"Warrior":0
}
</pre>

=== Room ===

* <code>room.name</code> (string)
* <code>room.vnum</code> (int)
* <code>room.sector</code> (string)
* <code>room.light</code> (int)
* <code>room.people_count</code> (int)
* <code>room.object_count</code> (int)

=== Time ===

* <code>time.hour</code>, <code>time.day</code>, <code>time.month</code>, <code>time.year</code> (int)
* <code>time.period</code> (string: "morning", "afternoon", "evening", "night")

== Example Template ==

<pre>
Welcome to the {{ room.name }}.
{% if room.people_count > 0 %}
There are others here.
{% else %}
You are alone.
{% endif %}

{{ random_choice(["A chill runs down your spine.", "You feel watched.", "The silence is deafening."]) }}
</pre>

== Notes ==

* All variables are read-only.
* No variable assignment or random logic is allowed except via the provided callbacks.

----
For more on inja syntax, see: https://pantor.github.io/inja/

INJA - Revision history