Map Editing - Revision history

Xarkanoth at 17:48, 11 July 2026

2026-07-11T17:48:55Z

@@ Line 1: / Line 1: @@
-<div class="hf-relpage">
+<div class="hf-relpage hf-reference-page hf-map-editing-page">
 {{Release_page_header|title=Map Editing}}
 <div class="hf-relpage-body">
@@ Line 11: / Line 11: @@
 }}
 <div class="hf-relpage-content">
 {{Release_section

Maintenance script at 02:20, 15 February 2026

2026-02-15T02:20:22Z

Maintenance script at 02:18, 15 February 2026

2026-02-15T02:18:23Z

← Older revision		Revision as of 04:18, 15 February 2026
Line 27:		Line 27:
	[[File:Holdfast CustomMap.jpg\|right\|600px\|CustomMap]]		[[File:Holdfast CustomMap.jpg\|right\|600px\|CustomMap]]

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">!map_rotation start		<pre class="hf-code">!map_rotation start
	map_name CustomMap		map_name CustomMap
	game_mode ArmyBattlefield		game_mode ArmyBattlefield
Line 50:		Line 50:
	To refresh changes to your map without restarting your server, issue the following (substitute the correct rotation index):		To refresh changes to your map without restarting your server, issue the following (substitute the correct rotation index):

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">rc fileReloader serverConfigFile		<pre class="hf-code">rc fileReloader serverConfigFile
	rc mapRotation 1</pre>		rc mapRotation 1</pre>

Line 66:		Line 66:
	This prints your position and rotation:		This prints your position and rotation:

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">playerPosition => (15.3, 16.8, 146.9)		<pre class="hf-code">playerPosition => (15.3, 16.8, 146.9)
	playerRotation => (0.0, 218.0, 0.0)</pre>		playerRotation => (0.0, 218.0, 0.0)</pre>

	* '''Position''' is (X, Y, Z). Positive X is North, positive Y is up, positive Z is West.		* '''Position''' is (X, Y, Z). Positive X is North, positive Y is up, positive Z is West.
	* '''Rotation''' is degrees around (X, Y, Z). You'll use '''Y''' most to turn objects; X and Z tilt.		* '''Rotation''' is degrees around (X, Y, Z). You'll use '''Y''' most to turn objects; X and Z tilt.
	* To face the opposite direction of the example above, use <code>(0.0, 38.0, 0.0)</code> (218 − 180).		* To face the opposite direction of the example above, use <code>(0.0, 38.0, 0.0)</code> (218 ??? 180).

	As of [[Game_Version_0.3X#0.35\|0.35]], <code>get details</code> also copies position & rotation to your clipboard for easy pasting.		As of [[Game_Version_0.3X#0.35\|0.35]], <code>get details</code> also copies position & rotation to your clipboard for easy pasting.
Line 87:		Line 87:
	See [[Spawnable Props\|Spawnable Props]] for the full list. Place a decorative prop with:		See [[Spawnable Props\|Spawnable Props]] for the full list. Place a decorative prop with:

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">objects_override <prop> <pX> <pY> <pZ> <rX> <rY> <rZ></pre>		<pre class="hf-code">objects_override <prop> <pX> <pY> <pZ> <rX> <rY> <rZ></pre>

	* '''<prop>''' — Enum from [[Spawnable Props\|Spawnable Props]]		* '''<prop>''' ??? Enum from [[Spawnable Props\|Spawnable Props]]
	* '''<pX> <pY> <pZ>''' — Position (use <code>get playerPosition</code>)		* '''<pX> <pY> <pZ>''' ??? Position (use <code>get playerPosition</code>)
	* '''<rX> <rY> <rZ>''' — Rotation (use <code>get playerRotation</code>)		* '''<rX> <rY> <rZ>''' ??? Rotation (use <code>get playerRotation</code>)

	[[File:Holdfast CustomMap TargetDummy.jpg\|right\|600px\|CustomMap]]		[[File:Holdfast CustomMap TargetDummy.jpg\|right\|600px\|CustomMap]]

	'''Example''' — add a Target Dummy at the example coordinates:		'''Example''' ??? add a Target Dummy at the example coordinates:

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">!map_rotation start		<pre class="hf-code">!map_rotation start
	map_name CustomMap		map_name CustomMap
	game_mode ArmyBattlefield		game_mode ArmyBattlefield
Line 128:		Line 128:
	Players can hold <kbd>E</kbd> to take weapons from a rack (limited supply).		Players can hold <kbd>E</kbd> to take weapons from a rack (limited supply).

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">objects_override WeaponRack <Object Position> <Object Rotation> <Weapon> <Number Of Weapons In Rack></pre>		<pre class="hf-code">objects_override WeaponRack <Object Position> <Object Rotation> <Weapon> <Number Of Weapons In Rack></pre>

	* '''<Object Position>''' — <code>x y z</code> (use <code>get playerPosition</code>)		* '''<Object Position>''' ??? <code>x y z</code> (use <code>get playerPosition</code>)
	* '''<Object Rotation>''' — <code>x y z</code> (use <code>get playerRotation</code>)		* '''<Object Rotation>''' ??? <code>x y z</code> (use <code>get playerRotation</code>)
	* '''<Weapon>''' — Enum from [[Server Configuration Enums#Weapon\|Weapon]]		* '''<Weapon>''' ??? Enum from [[Server Configuration Enums#Weapon\|Weapon]]
	* '''<Number Of Weapons In Rack>''' — <code>~~0–255~~</code>		* '''<Number Of Weapons In Rack>''' ??? <code>0???255</code>

	'''Example:'''		'''Example:'''
	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~"># Override Commands (This is a comment and will be ignored by the game)		<pre class="hf-code"># Override Commands (This is a comment and will be ignored by the game)
	objects_override WeaponRack 1 2 3 7 8 9 Rifle_Pattern1800Infantry 4</pre>		objects_override WeaponRack 1 2 3 7 8 9 Rifle_Pattern1800Infantry 4</pre>

Line 144:		Line 144:
	Customisable ammo boxes for RP/events. Players replenish ammo on use.		Customisable ammo boxes for RP/events. Players replenish ammo on use.

	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~">objects_override firearmammobox <Object Position> <Object Rotation> <Firearm> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></pre>		<pre class="hf-code">objects_override firearmammobox <Object Position> <Object Rotation> <Firearm> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></pre>

	* '''<Object Position>''' — <code>x y z</code>		* '''<Object Position>''' ??? <code>x y z</code>
	* '''<Object Rotation>''' — <code>x y z</code>		* '''<Object Rotation>''' ??? <code>x y z</code>
	* '''<Firearm>''' — Enum from [[Server Configuration Enums#Firearm\|Firearm]]		* '''<Firearm>''' ??? Enum from [[Server Configuration Enums#Firearm\|Firearm]]
	* '''<Maximum Interactions Until Depletion>''' — <code>~~0–255~~</code> total uses		* '''<Maximum Interactions Until Depletion>''' ??? <code>0???255</code> total uses
	* '''<Ammo Given>''' — <code>~~0–255~~</code> rounds per use		* '''<Ammo Given>''' ??? <code>0???255</code> rounds per use
	* '''<Maximum Interactions Allowed Per Player>''' — <code>~~0–255~~</code> per-player cap		* '''<Maximum Interactions Allowed Per Player>''' ??? <code>0???255</code> per-player cap

	'''Example:'''		'''Example:'''
	<pre ~~style~~="~~background:#111827;color:#e5e7eb;padding:.8em 1em;border~~-~~radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;~~"># Override Commands (This is a comment and will be ignored by the game)		<pre class="hf-code"># Override Commands (This is a comment and will be ignored by the game)
	objects_override firearmammobox 1 2 3 7 8 9 Rifle_Pattern1800Infantry 20 2 1</pre>		objects_override firearmammobox 1 2 3 7 8 9 Rifle_Pattern1800Infantry 20 2 1</pre>

Maintenance script at 02:43, 9 February 2026

2026-02-09T02:43:49Z

New page

<div class="hf-relpage">
{{Release_page_header|title=Map Editing}}
<div class="hf-relpage-body">
{{Release_TOC|content=
<div class="hf-toc-category">On this page</div>
<div>[[#starting-maps|Starting Maps]]</div>
<div>[[#positioning|Positioning]]</div>
<div>[[#placing-props|Placing Props]]</div>
<div>[[#polishing|Polishing Up]]</div>
<div>[[#community|Community Maps]]</div>
}}
<div class="hf-relpage-content">

{{Release_section
|id=overview
|title=Overview
|content=
Holdfast allows server owners to customise existing maps to create a whole new experience. You can add props, change spawns, weapon setup, class limits, and more until you've created something entirely new. Map customisation is defined using [[Server Configuration#Map_Rotations|Map Rotations]] in the configuration file.
}}

{{Release_section
|id=starting-maps
|title=Starting Maps
|content=
As well as building upon the normal [[Server Configuration#Maps|maps]], there are two flat and empty maps that are perfect to let your imagination run wild: '''CustomMap''' and '''CustomMapNaval'''. As you'll likely spend plenty of time setting up your new map, create a new [[Server Configuration#Map_Rotations|rotation]] with an unlimited timer and open spawns, e.g.:

[[File:Holdfast CustomMap.jpg|right|600px|CustomMap]]

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">!map_rotation start
map_name CustomMap
game_mode ArmyBattlefield
round_time_minutes -1
reinforcements_per_faction 9000
wave_spawn_time_seconds 1
max_player_respawns -1
faction_balancing false
allow_midround_spawning true
allow_faction_switching true
allow_spectating true
minimum_players -1
maximum_players 150
time_hour 8
time_dynamic false
friendly_fire true
weather_preset calm
weather_dynamic false
game_type hardcore
!map_rotation end</pre>

To refresh changes to your map without restarting your server, issue the following (substitute the correct rotation index):

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">rc fileReloader serverConfigFile
rc mapRotation 1</pre>

<div style="clear:both;"></div>
}}

{{Release_section
|id=positioning
|title=Positioning
|content=
Before placing a prop, decide where it goes and which way it faces. Stand where you want it in-game, open the console with <code>F1</code> and type <code>get</code>.

[[File:Holdfast Console Get.png|left|350px|The output of get]]

This prints your position and rotation:

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">playerPosition => (15.3, 16.8, 146.9)
playerRotation => (0.0, 218.0, 0.0)</pre>

* '''Position''' is (X, Y, Z). Positive X is North, positive Y is up, positive Z is West.
* '''Rotation''' is degrees around (X, Y, Z). You'll use '''Y''' most to turn objects; X and Z tilt.
* To face the opposite direction of the example above, use <code>(0.0, 38.0, 0.0)</code> (218 − 180).

As of [[Game_Version_0.3X#0.35|0.35]], <code>get details</code> also copies position & rotation to your clipboard for easy pasting.

<div style="clear:both;"></div>
}}

{{Release_section
|id=placing-props
|title=Placing Props
|content=
Props range from simple decor (just position/rotation) to interactables (with extra parameters).

=== Decorative Props ===
See [[Spawnable Props|Spawnable Props]] for the full list. Place a decorative prop with:

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">objects_override <prop> <pX> <pY> <pZ> <rX> <rY> <rZ></pre>

* '''<prop>''' — Enum from [[Spawnable Props|Spawnable Props]]
* '''<pX> <pY> <pZ>''' — Position (use <code>get playerPosition</code>)
* '''<rX> <rY> <rZ>''' — Rotation (use <code>get playerRotation</code>)

[[File:Holdfast CustomMap TargetDummy.jpg|right|600px|CustomMap]]

'''Example''' — add a Target Dummy at the example coordinates:

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">!map_rotation start
map_name CustomMap
game_mode ArmyBattlefield
round_time_minutes -1
reinforcements_per_faction 9000
wave_spawn_time_seconds 1
max_player_respawns -1
faction_balancing false
allow_midround_spawning true
allow_faction_switching true
allow_spectating true
minimum_players -1
maximum_players 150
time_hour 8
time_dynamic false
friendly_fire true
weather_preset calm
weather_dynamic false
game_type hardcore

objects_override TargetDummy 15.3 16.8 146.9 0.0 218.0 0.0
!map_rotation end</pre>

<div style="clear:both;"></div>

=== Interactable Props ===
These require extra arguments.

==== Weapon Racks ====
Players can hold <kbd>E</kbd> to take weapons from a rack (limited supply).

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">objects_override WeaponRack <Object Position> <Object Rotation> <Weapon> <Number Of Weapons In Rack></pre>

* '''<Object Position>''' — <code>x y z</code> (use <code>get playerPosition</code>)
* '''<Object Rotation>''' — <code>x y z</code> (use <code>get playerRotation</code>)
* '''<Weapon>''' — Enum from [[Server Configuration Enums#Weapon|Weapon]]
* '''<Number Of Weapons In Rack>''' — <code>0–255</code>

'''Example:'''
<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;"># Override Commands (This is a comment and will be ignored by the game)
objects_override WeaponRack 1 2 3 7 8 9 Rifle_Pattern1800Infantry 4</pre>

Place this between <code>!map_rotation start</code> and <code>!map_rotation end</code>.

==== Firearm Ammoboxes ====
Customisable ammo boxes for RP/events. Players replenish ammo on use.

<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;">objects_override firearmammobox <Object Position> <Object Rotation> <Firearm> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></pre>

* '''<Object Position>''' — <code>x y z</code>
* '''<Object Rotation>''' — <code>x y z</code>
* '''<Firearm>''' — Enum from [[Server Configuration Enums#Firearm|Firearm]]
* '''<Maximum Interactions Until Depletion>''' — <code>0–255</code> total uses
* '''<Ammo Given>''' — <code>0–255</code> rounds per use
* '''<Maximum Interactions Allowed Per Player>''' — <code>0–255</code> per-player cap

'''Example:'''
<pre style="background:#111827;color:#e5e7eb;padding:.8em 1em;border-radius:.6em;overflow:auto;line-height:1.45;font-size:.9em;"># Override Commands (This is a comment and will be ignored by the game)
objects_override firearmammobox 1 2 3 7 8 9 Rifle_Pattern1800Infantry 20 2 1</pre>

Place this between <code>!map_rotation start</code> and <code>!map_rotation end</code>.
}}

{{Release_section
|id=polishing
|title=Polishing Up
|content=
Once your map is laid out, adjust class limits, spawns, and other settings as usual via the [[Server Configuration|Server Configuration]] guide.
}}

{{Release_section
|id=community
|title=Community Maps
|content=
The Holdfast modding community shares custom map configs and assists new modders. Join via the official Discord:

[https://discord.gg/holdfastgame Holdfast Official Discord]

Once joined, go to the [https://discord.com/channels/306195621373542400/738090850772451388 #become-a-modder] channel and click the button to get the '''Modder''' role to unlock the Modding Bench channels.
}}

</div>
</div>
</div>

← Older revision		Revision as of 04:20, 15 February 2026
Line 71:		Line 71:
	* '''Position''' is (X, Y, Z). Positive X is North, positive Y is up, positive Z is West.		* '''Position''' is (X, Y, Z). Positive X is North, positive Y is up, positive Z is West.
	* '''Rotation''' is degrees around (X, Y, Z). You'll use '''Y''' most to turn objects; X and Z tilt.		* '''Rotation''' is degrees around (X, Y, Z). You'll use '''Y''' most to turn objects; X and Z tilt.
	* To face the opposite direction of the example above, use <code>(0.0, 38.0, 0.0)</code> (218 ~~???~~ 180).		* To face the opposite direction of the example above, use <code>(0.0, 38.0, 0.0)</code> (218 - 180).

	As of [[Game_Version_0.3X#0.35\|0.35]], <code>get details</code> also copies position & rotation to your clipboard for easy pasting.		As of [[Game_Version_0.3X#0.35\|0.35]], <code>get details</code> also copies position & rotation to your clipboard for easy pasting.
Line 89:		Line 89:
	<pre class="hf-code">objects_override <prop> <pX> <pY> <pZ> <rX> <rY> <rZ></pre>		<pre class="hf-code">objects_override <prop> <pX> <pY> <pZ> <rX> <rY> <rZ></pre>

	* '''<prop>''' ~~???~~ Enum from [[Spawnable Props\|Spawnable Props]]		* '''<prop>''' — Enum from [[Spawnable Props\|Spawnable Props]]
	* '''<pX> <pY> <pZ>''' ~~???~~ Position (use <code>get playerPosition</code>)		* '''<pX> <pY> <pZ>''' — Position (use <code>get playerPosition</code>)
	* '''<rX> <rY> <rZ>''' ~~???~~ Rotation (use <code>get playerRotation</code>)		* '''<rX> <rY> <rZ>''' — Rotation (use <code>get playerRotation</code>)

	[[File:Holdfast CustomMap TargetDummy.jpg\|right\|600px\|CustomMap]]		[[File:Holdfast CustomMap TargetDummy.jpg\|right\|600px\|CustomMap]]

	'''Example''' ~~???~~ add a Target Dummy at the example coordinates:		'''Example''' — add a Target Dummy at the example coordinates:

	<pre class="hf-code">!map_rotation start		<pre class="hf-code">!map_rotation start
Line 130:		Line 130:
	<pre class="hf-code">objects_override WeaponRack <Object Position> <Object Rotation> <Weapon> <Number Of Weapons In Rack></pre>		<pre class="hf-code">objects_override WeaponRack <Object Position> <Object Rotation> <Weapon> <Number Of Weapons In Rack></pre>

	* '''<Object Position>''' ~~???~~ <code>x y z</code> (use <code>get playerPosition</code>)		* '''<Object Position>''' — <code>x y z</code> (use <code>get playerPosition</code>)
	* '''<Object Rotation>''' ~~???~~ <code>x y z</code> (use <code>get playerRotation</code>)		* '''<Object Rotation>''' — <code>x y z</code> (use <code>get playerRotation</code>)
	* '''<Weapon>''' ~~???~~ Enum from [[Server Configuration Enums#Weapon\|Weapon]]		* '''<Weapon>''' — Enum from [[Server Configuration Enums#Weapon\|Weapon]]
	* '''<Number Of Weapons In Rack>''' ~~???~~ <code>0~~???~~255</code>		* '''<Number Of Weapons In Rack>''' — <code>0-255</code>

	'''Example:'''		'''Example:'''
Line 146:		Line 146:
	<pre class="hf-code">objects_override firearmammobox <Object Position> <Object Rotation> <Firearm> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></pre>		<pre class="hf-code">objects_override firearmammobox <Object Position> <Object Rotation> <Firearm> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></pre>

	* '''<Object Position>''' ~~???~~ <code>x y z</code>		* '''<Object Position>''' — <code>x y z</code>
	* '''<Object Rotation>''' ~~???~~ <code>x y z</code>		* '''<Object Rotation>''' — <code>x y z</code>
	* '''<Firearm>''' ~~???~~ Enum from [[Server Configuration Enums#Firearm\|Firearm]]		* '''<Firearm>''' — Enum from [[Server Configuration Enums#Firearm\|Firearm]]
	* '''<Maximum Interactions Until Depletion>''' ~~???~~ <code>0~~???~~255</code> total uses		* '''<Maximum Interactions Until Depletion>''' — <code>0-255</code> total uses
	* '''<Ammo Given>''' ~~???~~ <code>0~~???~~255</code> rounds per use		* '''<Ammo Given>''' — <code>0-255</code> rounds per use
	* '''<Maximum Interactions Allowed Per Player>''' ~~???~~ <code>0~~???~~255</code> per-player cap		* '''<Maximum Interactions Allowed Per Player>''' — <code>0-255</code> per-player cap

	'''Example:'''		'''Example:'''