Player Housing: Difference between revisions

From Sinfar
(Rebuild Player Housing page with compact builder-reference formatting and searchable tileset tables.)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
====== Housing System ======
NOTOC


===== Basic Guidelines =====
<div style="background:#0b090a; border:1px solid #6f5730; color:#e8dcc8; padding:16px; box-shadow:0 0 22px rgba(0,0,0,0.35); font-size:14px; line-height:1.5;"><div style="text-align:center; border:1px solid #8b6b3a; background:linear-gradient(180deg,#181214,#0b090a); padding:12px 14px; margin-bottom:10px;">
<div style="font-family:Georgia,serif; font-size:30px; letter-spacing:3px; color:#d8b46a; text-shadow:0 0 10px rgba(143,36,50,0.55);">
PLAYER HOUSING
</div>
<div style="margin-top:5px; color:#c9bda9;">
Building, exporting, uploading, and maintaining Sinfar player homes.
</div>
</div><div style="background:#181214; border-left:4px solid #8f2432; border-top:1px solid #6f5730; border-bottom:1px solid #6f5730; padding:10px 12px; margin-bottom:10px;">
Player houses are custom-built interiors uploaded as ERF files. They must follow Sinfar housing limits, use approved tilesets, include a valid main door, and avoid restricted content such as unsupported creatures, items, merchants, or scripts.
</div><div style="font-family:Georgia,serif; font-size:21px; color:#d8b46a; border-bottom:1px solid #6f5730; padding-bottom:4px; margin:8px 0 5px 0;">
Quick Index
</div><table style="width:100%; border-collapse:separate; border-spacing:8px; color:#e8dcc8;">
<tr>
<td style="width:25%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Basic_Guidelines|Basic Guidelines]]'''<br>
Minimum requirements, limits, and restricted content.
</td>
<td style="width:25%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Acquiring_a_House|Acquiring a House]]'''<br>
Finding a house sign and using the realtor.
</td>
<td style="width:25%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Building_Your_House|Building Your House]]'''<br>
Toolset setup, first area, ERF export, upload.
</td>
<td style="width:25%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Using_Scripts|Using Scripts]]'''<br>
Default scripts, approved scripts, custom scripting.
</td>
</tr>
<tr>
<td style="width:25%; vertical-align:top; background:#181214; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Sinfar_Home_Builders_Guide|Builder Guide]]'''<br>
External guide download.
</td>
<td colspan="3" style="width:75%; vertical-align:top; background:#181214; border:1px solid #6f5730; padding:10px 12px;">
'''[[#Available_Tilesets|Available Tilesets]]'''<br>
Housing Interior, Exterior Wild/Rural, Misc, Exterior City/Town, Caves/Dungeons, Catacombs/Sewers, Barrows/Crypts/Ruins.
</td>
</tr>
</table><div id="Basic_Guidelines" style="font-family:Georgia,serif; font-size:21px; color:#d8b46a; border-bottom:1px solid #6f5730; padding-bottom:4px; margin:9px 0 5px 0;">
Basic Guidelines
</div><table style="width:100%; border-collapse:separate; border-spacing:8px; color:#e8dcc8;">
<tr>
<td style="width:33%; vertical-align:top; background:#21171a; border:1px solid #8f2432; padding:10px 12px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Required</div>A player home must contain at least the following things:


A player home must contain at least the following things:
* 1 2x2 area made of one of the allowed tilesets.
* A door with the tag <code>MAIN_DOOR</code> that will be used to leave the house.
* Choose a specific loading screen.


* 1 2x2 area made of one of the allowed tilesets.
<div style="background:#120d10; border-left:4px solid #d8b46a; padding:8px 10px; margin-top:8px;">
* A door with the tag "MAIN_DOOR" that will be used to leave the house.
The default loading screen is set to random, which is bad.
* Choose a specific loading screen. (The default the loading screen is set to random, which is bad.)
</div>
</td><td style="width:33%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Allowed Building Options</div>You can then choose:


You can then choose the area lightning and ambient music that you want, add placeables, sounds, more doors, waypoints, triggers, visual effects and more!
* Area lightning
* Ambient music
* Placeables
* Sounds
* More doors
* Waypoints
* Triggers
* Visual effects
* More


Each area can have up to 1500 objects and 250 of them can be dynamic, a dynamic object is either a non-static placeable, a door, a trigger or a visual effect. Sinfar Supporters limit is twice that amount (500 dynamic and 3000 static).
</td><td style="width:33%; vertical-align:top; background:#21171a; border:1px solid #6f5730; padding:10px 12px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Object Limits</div>Each area can have up to:


(You may not put in your own items or creatures, or any merchants or scripts beyond those supported on Sinfar's houses script list page.)
* 1500 objects
===== Acquiring a House =====
* 250 dynamic objects


# Find a location: Player houses are characterized by a sign with a title such as "House #5", next to a door and the sign should say "For sale!" with the details on how the interior can be designed, for example: [[File:housing_20190317-144222.png|thumb]] [[File:housing_20190317-144520.png|thumb]]
A dynamic object is either:
# Go the the realtor: There's one for most islands or you can cheat and use the one in the OOC which is for all islands:  https://www.youtube.com/watch?v=2q-MsU8YXZ0


===== Building Your House =====
* A non-static placeable
* A door
* A trigger
* A visual effect


==== Open the  Editor ====
Sinfar Supporters limit is twice that amount:


The interior of you house can be built using the [https://nwn.fandom.com/wiki/Toolset Neverwinter Nights Toolset].
* 500 dynamic
* 3000 static


You can start building with this module: [https://neverwintervault.org/sites/all/modules/pubdlcnt/pubdlcnt.php?fid=200115 Sinfar v30 home module]
</td>
# Extract the module to your NWN\modules folder.
</tr>
# Extract the hak to your NWN\hak folder.
</table><div style="background:#120d10; border-left:4px solid #8f2432; padding:8px 10px; margin:6px 0 8px 0;">
You may not put in your own items or creatures, or any merchants or scripts beyond those supported on Sinfar's houses script list page.
</div><div id="Acquiring_a_House" style="font-family:Georgia,serif; font-size:21px; color:#91d38f; border-bottom:1px solid #446b35; padding-bottom:4px; margin:9px 0 5px 0;">
Acquiring a House
</div><table style="width:100%; border-collapse:separate; border-spacing:8px; color:#e8dcc8;">
<tr>
<td style="width:58%; vertical-align:top; background:#111a12; border:1px solid #446b35; padding:12px 14px;">
# Find a location: Player houses are characterized by a sign with a title such as "House #5", next to a door and the sign should say "For sale!" with the details on how the interior can be designed, for example:
# Go the the realtor: There's one for most islands or you can cheat and use the one in the OOC which is for all islands:<div style="background:#120d10; border:1px solid #446b35; padding:8px 10px; margin-top:8px;">
https://www.youtube.com/watch?v=2q-MsU8YXZ0
</div>
</td>
<td style="width:42%; vertical-align:top; background:#111a12; border:1px solid #446b35; padding:10px 12px; text-align:center;">
[[File:housing_20190317-144222.png|260px]]
[[File:housing_20190317-144520.png|260px]]
<div style="font-size:12px; color:#b7a995; margin-top:4px;">Example house sale signs.</div>
</td>
</tr>
</table><div id="Building_Your_House" style="font-family:Georgia,serif; font-size:21px; color:#8fc6ff; border-bottom:1px solid #34577a; padding-bottom:4px; margin:9px 0 5px 0;">
Building Your House
</div><div style="font-family:Georgia,serif; font-size:19px; color:#8fc6ff; border-bottom:1px solid #34577a; padding-bottom:4px; margin:9px 0 5px 0;">
Open the Editor
</div><div style="background:#101820; border:1px solid #34577a; padding:12px 14px; margin-bottom:8px;">The interior of you house can be built using the [https://nwn.fandom.com/wiki/Toolset Neverwinter Nights Toolset].


==== Create the First Area ====
You can start building with this module:
# Select one of the allowed tileset.
# Select a size within the allowed range (the format on the deed is: Width x Height).
# Add a door and set the tag to "MAIN_DOOR". This is the door that will be used to enter and leave the house, you don't have anything else to do, its transition will be setup automatically. It can have a custom appearance and the exterior door will be updated to have the same appearance.


==== Upload the Module ====
<div style="background:#120d10; border:1px solid #34577a; padding:8px 10px; margin:8px 0;">
Save the module, upload it:
[https://neverwintervault.org/sites/all/modules/pubdlcnt/pubdlcnt.php?fid=200115 Sinfar v30 home module]
# Open the [https://nwn.sinfar.net/houses_uploadform.php House Upload Page].
</div>Extract the module to your <code>NWN\modules</code> folder.
# Enter your house ID and secret code, both can be found by examining your deed in game.
# Select your house module, it should be in your NWN\modules folder. You can optionally compress it.
# Click the Upload button.


The server will process your module, validate all areas and strip everything that is not allowed and if everything goes well, you will get a message saying that your house is now in game.
Extract the hak to your <code>NWN\hak</code> folder.


Here's what the process looks like: https://www.youtube.com/watch?v=2xAte-Rm7Bg
</div><div style="font-family:Georgia,serif; font-size:19px; color:#8fc6ff; border-bottom:1px solid #34577a; padding-bottom:4px; margin:9px 0 5px 0;">
Create the First Area
</div><div style="background:#101820; border:1px solid #34577a; padding:12px 14px; margin-bottom:8px;">Select one of the allowed tileset.


===== Using Scripts =====
Select a size within the allowed range. The format on the deed is: <code>Width x Height</code>.


===Default Scripts ===
Add a door and set the tag to <code>MAIN_DOOR</code>.
Some objects will have a default scripts attached to them:
# Plot placeable with an inventory will have a script to make their inventory persistent


===Approved Scripts ===
This is the door that will be used to enter and leave the house, you don't have anything else to do, its transition will be setup automatically. It can have a custom appearance and the exterior door will be updated to have the same appearance.
You can use any of the scripts that are listed here: [https://nwn.sinfar.net/houses_scriptlist.php Scripts for houses], with the following restrictions:
# You can only use one script per object
# When an object is using a script from this list, it will not have a default script, so for example, a plot placeable with an inventory won't be persistent... if it is using one of those scripts.
# Each script has a specific list of variable and any other variable name/type will be automatically removed
# Make sure to read the script description, some require that placeable by dynamic, some can only be use a certain number of time...


You can find more details here: [[Custom Scripting]].
</div><div style="font-family:Georgia,serif; font-size:19px; color:#8fc6ff; border-bottom:1px solid #34577a; padding-bottom:4px; margin:9px 0 5px 0;">
Export the Area ERF(s)
</div><table style="width:100%; border-collapse:separate; border-spacing:8px; color:#e8dcc8;">
<tr>
<td style="width:50%; vertical-align:top; background:#101820; border:1px solid #34577a; padding:12px 14px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Single-Area Home</div>If your home is a single area, you can simply right click on the area in the left hand menu and select ''''Export Area'''<nowiki/>', this will prompt you to save the .erf file ready for uploading.


===== How to Make Scripts, Dialogs, Creatures and Other Restricted Blueprints for inside Your House =====
</td>
<td style="width:50%; vertical-align:top; background:#101820; border:1px solid #34577a; padding:12px 14px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Multi-Area Home</div>For a multi-area home you will need to use the resource exporter to create the ERF file of your areas:


The housing system is made so that you can even make your own scripts for inside your house and they will have no effect outside of it when ran. This feature is although restricted to selected players and Sinfar Supporters.
With the editor open, open the '''File menu''' and select '''Export''' this will open a new window will open to ''''Export Resources'''<nowiki/>',


Read more here: https://sinfar.net/features/housing/custom_scripts
In the new window click ''''Add Resources'''<nowiki/>' which then opens up a new resource selection window,


== Sinfar Home Builders Guide ==
If necessary at the bottom change the '<nowiki/>'''Resources of Type:'''<nowiki/>' selector to ''''Area File'''',
The Sinfar player home building guide may be found here: [https://neverwintervault.org/sites/all/modules/pubdlcnt/pubdlcnt.php?fid=33050 Sinfar Home Builder's Guide]
 
Select the areas you wish to export, and click ''''Export'''<nowiki/>' which will close the selctor dialog,
 
Once you have all the areas you wish to export listed, click '<nowiki/>'''OK'''<nowiki/>' and you will be prompted to save the created ''''.erf'''<nowiki/>' file.
 
After you have chosen the save filename and location you'll be prompted to add any comments to the ERF, you can click ''''OK'''<nowiki/>' again to leave the comments field empty.
 
You should now have your .erf file ready to be uploaded to the server.
 
</td>
</tr>
</table><div style="font-family:Georgia,serif; font-size:19px; color:#8fc6ff; border-bottom:1px solid #34577a; padding-bottom:4px; margin:9px 0 5px 0;">
Upload the ERF
</div><div style="background:#101820; border:1px solid #34577a; padding:12px 14px; margin-bottom:8px;">Open the [https://nwn.sinfar.net/houses_uploadform.php House Upload Page].
 
Enter your house ID and secret code, both can be found by examining your deed in game.
 
Select your house erf, it should be in your <code>NWN\erf</code> folder.
 
You can optionally compress it.
 
Click the Upload button.
 
The server will process your erf, validate all areas and strip everything that is not allowed and if everything goes well, you will get a message saying that your house is now in game.
 
</div><div id="Using_Scripts" style="font-family:Georgia,serif; font-size:21px; color:#ff9c8f; border-bottom:1px solid #7a342f; padding-bottom:4px; margin:9px 0 5px 0;">
Using Scripts
</div><table style="width:100%; border-collapse:separate; border-spacing:8px; color:#e8dcc8;">
<tr>
<td style="width:50%; vertical-align:top; background:#1a1010; border:1px solid #7a342f; padding:12px 14px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Default Scripts</div>Some objects will have a default scripts attached to them:
 
Plot placeable with an inventory will have a script to make their inventory persistent
 
</td>
<td style="width:50%; vertical-align:top; background:#1a1010; border:1px solid #7a342f; padding:12px 14px;">
<div style="font-family:Georgia,serif; font-size:18px; color:#d8b46a; margin-bottom:6px;">Approved Scripts</div>You can use any of the scripts that are listed here:
 
<div style="background:#120d10; border:1px solid #7a342f; padding:8px 10px; margin:8px 0;">
[https://nwn.sinfar.net/houses_scriptlist.php Scripts for houses]
</div>You can find more details here: [[Custom Scripting]].
 
</td>
</tr>
</table><div style="background:#120d10; border-left:4px solid #8f2432; padding:8px 10px; margin-bottom:8px;">
'''Approved Script Restrictions'''You can only use one script per object
 
When an object is using a script from this list, it will not have a default script, so for example, a plot placeable with an inventory won't be persistent if it is using one of those scripts.
 
Each script has a specific list of variable and any other variable name/type will be automatically removed
 
Make sure to read the script description, some require that placeable by dynamic, some can only be use a certain number of time...
 
</div><div style="font-family:Georgia,serif; font-size:19px; color:#ff9c8f; border-bottom:1px solid #7a342f; padding-bottom:4px; margin:9px 0 5px 0;">
How to Make Scripts, Dialogs, Creatures and Other Restricted Blueprints for inside Your House
</div><div style="background:#1a1010; border:1px solid #7a342f; padding:12px 14px; margin-bottom:8px;">The housing system is made so that you can even make your own scripts for inside your house and they will have no effect outside of it when ran. This feature is although restricted to selected players and Sinfar Supporters.
 
Read more here:
 
<div style="background:#120d10; border:1px solid #7a342f; padding:8px 10px; margin-top:8px;">
https://sinfar.net/features/housing/custom_scripts
</div></div><div id="Sinfar_Home_Builders_Guide" style="font-family:Georgia,serif; font-size:21px; color:#c49cff; border-bottom:1px solid #5b3b78; padding-bottom:4px; margin:9px 0 5px 0;">
Sinfar Home Builders Guide
</div><div style="background:#19111d; border:1px solid #5b3b78; padding:12px 14px; margin-bottom:8px;">
The Sinfar player home building guide may be found here:<div style="background:#120d10; border:1px solid #5b3b78; padding:8px 10px; margin-top:8px;">
[https://neverwintervault.org/sites/all/modules/pubdlcnt/pubdlcnt.php?fid=33050 Sinfar Home Builder's Guide]
</div>
</div><div id="Available_Tilesets" style="font-family:Georgia,serif; font-size:21px; color:#d8b46a; border-bottom:1px solid #6f5730; padding-bottom:4px; margin:9px 0 5px 0;">
Available Tilesets
</div><div style="background:#181214; border:1px solid #6f5730; padding:10px 12px; margin-bottom:8px;">
The following tilesets are currently listed for player housing.
</div><div style="display:flex; flex-wrap:wrap; gap:8px; align-items:flex-start;"><table style="width:250px; border-collapse:collapse; background:#101820; color:#e8dcc8; border:1px solid #34577a;">
<caption style="font-family:Georgia,serif; color:#8fc6ff; font-size:18px; padding:4px;">Housing Interior</caption>
<tr><th style="background:#17324a; color:#d8b46a; padding:6px;">Name</th><th style="background:#17324a; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Castle Interior 1 [CEP]</td><td><code>tic01</code></td></tr>
<tr><td>Castle Interior 2</td><td><code>tni02</code></td></tr>
<tr><td>City Interior 1 [CEP]</td><td><code>tin01</code></td></tr>
<tr><td>City Interior 2</td><td><code>tni01</code></td></tr>
<tr><td>Drow Interior [CEP]</td><td><code>tid01</code></td></tr>
<tr><td>Elven Interiors, Marble</td><td><code>bvi80</code></td></tr>
<tr><td>Elven Interiors, Wooden</td><td><code>pie23</code></td></tr>
<tr><td>Fancy Castle</td><td><code>fla01</code></td></tr>
<tr><td>Fort Interior</td><td><code>twc03</code></td></tr>
<tr><td>Gothic Interior</td><td><code>gi</code></td></tr>
<tr><td>Illithid Interior</td><td><code>tii01</code></td></tr>
<tr><td>Medieval Keep Interior</td><td><code>tei02</code></td></tr>
<tr><td>Modern Office Interiors</td><td><code>udp2</code></td></tr>
<tr><td>NWN2 Houses</td><td><code>tms02</code></td></tr>
<tr><td>Oriental Interior</td><td><code>ori02</code></td></tr>
<tr><td>Sen's Rural Inn</td><td><code>sic11</code></td></tr>
<tr><td>Sigil, Stern Interior [CODI]</td><td><code>thv01</code></td></tr>
<tr><td>SJ Wood Interior</td><td><code>tis01</code></td></tr>
<tr><td>White Marble Castle</td><td><code>mbc30</code></td></tr>
<tr><td>Workshop</td><td><code>wks01</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#111a12; color:#e8dcc8; border:1px solid #446b35;">
<caption style="font-family:Georgia,serif; color:#91d38f; font-size:18px; padding:4px;">Exterior Wild/Rural</caption>
<tr><th style="background:#183618; color:#d8b46a; padding:6px;">Name</th><th style="background:#183618; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Barren Lands</td><td><code>isc03</code></td></tr>
<tr><td>Desert [CEP]</td><td><code>ttd01</code></td></tr>
<tr><td>Desert, Babylon [CTP]</td><td><code>tced0</code></td></tr>
<tr><td>Forest [CEP]</td><td><code>ttf01</code></td></tr>
<tr><td>Frozen Waste [CEP]</td><td><code>tti01</code></td></tr>
<tr><td>Medieval Forest</td><td><code>tfm01</code></td></tr>
<tr><td>Rural Grass [CEP]</td><td><code>ttr01</code></td></tr>
<tr><td>Rural Winter [CEP]</td><td><code>tts01</code></td></tr>
<tr><td>Swamps [CEP]</td><td><code>zkw01</code></td></tr>
<tr><td>Tropical</td><td><code>ttz01</code></td></tr>
<tr><td>Urban Wasteland</td><td><code>wlu01</code></td></tr>
<tr><td>Wild Woods</td><td><code>ttw01</code></td></tr>
<tr><td>Wildlands</td><td><code>twl01</code></td></tr>
<tr><td>Wildlands Winter</td><td><code>twl02</code></td></tr>
<tr><td>Worms Cypress Bayou</td><td><code>wcs10</code></td></tr>
<tr><td>Worms Dense Jungle</td><td><code>wdj01</code></td></tr>
<tr><td>Worms Desert Plains</td><td><code>wdp01</code></td></tr>
<tr><td>Worms Fantasy Interiors</td><td><code>wdd04</code></td></tr>
<tr><td>Worms Forest Summer</td><td><code>wsf10</code></td></tr>
<tr><td>Worms Jungle Mountains</td><td><code>tjj01</code></td></tr>
<tr><td>Worms Mirkwood Swamps</td><td><code>wms01</code></td></tr>
<tr><td>Worms Outer Limits</td><td><code>wcc01</code></td></tr>
<tr><td>Worms Scorched Earth</td><td><code>wlf01</code></td></tr>
<tr><td>Worms Undersea</td><td><code>wut01</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#19111d; color:#e8dcc8; border:1px solid #5b3b78;">
<caption style="font-family:Georgia,serif; color:#c49cff; font-size:18px; padding:4px;">Misc</caption>
<tr><th style="background:#301842; color:#d8b46a; padding:6px;">Name</th><th style="background:#301842; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Arena</td><td><code>tte30</code></td></tr>
<tr><td>Future, Secret Base</td><td><code>tcdh0</code></td></tr>
<tr><td>PHoD Bunker 1</td><td><code>fifi1</code></td></tr>
<tr><td>PHoD Bunker 2</td><td><code>fifi2</code></td></tr>
<tr><td>PHoD Bunker 3</td><td><code>fifi3</code></td></tr>
<tr><td>PHoD Metal Vault Interior</td><td><code>mbc31</code></td></tr>
<tr><td>PHoD Metal Wasteland 1</td><td><code>tsr02</code></td></tr>
<tr><td>PHoD Vault - Ancient</td><td><code>phodd</code></td></tr>
<tr><td>PHoD Vault - Exotic</td><td><code>phoda</code></td></tr>
<tr><td>PHoD Vault - Lumpy</td><td><code>phode</code></td></tr>
<tr><td>PHoD Vault - Murky</td><td><code>phodf</code></td></tr>
<tr><td>PHoD Vault - Strange</td><td><code>phodb</code></td></tr>
<tr><td>PHoD Vault - Tainted</td><td><code>phodc</code></td></tr>
<tr><td>Ship Interior</td><td><code>nex01</code></td></tr>
<tr><td>Starship Interiors</td><td><code>shp02</code></td></tr>
<tr><td>Worms Wagon Travel Interior</td><td><code>tms01</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#1a1010; color:#e8dcc8; border:1px solid #7a342f;">
<caption style="font-family:Georgia,serif; color:#ff9c8f; font-size:18px; padding:4px;">Exterior City/Town</caption>
<tr><th style="background:#4a1717; color:#d8b46a; padding:6px;">Name</th><th style="background:#4a1717; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Aztec Exterior</td><td><code>tze01</code></td></tr>
<tr><td>Castle Exterior, Rural</td><td><code>tno01</code></td></tr>
<tr><td>City Exterior [CEP]</td><td><code>tcn01</code></td></tr>
<tr><td>Complete Rural/City</td><td><code>tcr10</code></td></tr>
<tr><td>Elven Treetop City</td><td><code>thf02</code></td></tr>
<tr><td>Gothic Estates</td><td><code>gg</code></td></tr>
<tr><td>Medieval City</td><td><code>tcm01</code></td></tr>
<tr><td>Medieval Rural</td><td><code>trm01</code></td></tr>
<tr><td>Modern Suburbs</td><td><code>udp1</code></td></tr>
<tr><td>Oriental Rural</td><td><code>ori01</code></td></tr>
<tr><td>Sigil, Exterior [CODI]</td><td><code>tps01</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#101820; color:#e8dcc8; border:1px solid #34577a;">
<caption style="font-family:Georgia,serif; color:#8fc6ff; font-size:18px; padding:4px;">Caves/Dungeons</caption>
<tr><th style="background:#17324a; color:#d8b46a; padding:6px;">Name</th><th style="background:#17324a; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Classic Dungeon</td><td><code>cdlif</code></td></tr>
<tr><td>Dungeon [CEP]</td><td><code>tde01</code></td></tr>
<tr><td>Dwarven Chasms</td><td><code>isc04</code></td></tr>
<tr><td>Eye of the Beholder</td><td><code>tei01</code></td></tr>
<tr><td>Mines and Caverns [CEP]</td><td><code>tdm01</code></td></tr>
<tr><td>Sea Caves</td><td><code>tdt01</code></td></tr>
<tr><td>Sen's Icy Caverns</td><td><code>sic01</code></td></tr>
<tr><td>Sen's Mines and Caverns</td><td><code>scv01</code></td></tr>
<tr><td>Sen's Underdark</td><td><code>sdg01</code></td></tr>
<tr><td>Underdark [CEP]</td><td><code>ttu01</code></td></tr>
<tr><td>Versatile Dungeon</td><td><code>tvd</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#111a12; color:#e8dcc8; border:1px solid #446b35;">
<caption style="font-family:Georgia,serif; color:#91d38f; font-size:18px; padding:4px;">Catacombs/Sewers</caption>
<tr><th style="background:#183618; color:#d8b46a; padding:6px;">Name</th><th style="background:#183618; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Catacombs</td><td><code>twl04</code></td></tr>
<tr><td>Sewers</td><td><code>tds01</code></td></tr>
<tr><td>Steamworks</td><td><code>tsw01</code></td></tr>
<tr><td>Undercity Sewer</td><td><code>isc02</code></td></tr>
</table><table style="width:250px; border-collapse:collapse; background:#19111d; color:#e8dcc8; border:1px solid #5b3b78;">
<caption style="font-family:Georgia,serif; color:#c49cff; font-size:18px; padding:4px;">Barrows/Crypts/Ruins</caption>
<tr><th style="background:#301842; color:#d8b46a; padding:6px;">Name</th><th style="background:#301842; color:#d8b46a; padding:6px;">Tileset</th></tr>
<tr><td>Barrows Interior</td><td><code>tbw01</code></td></tr>
<tr><td>Beholder Interior [CEP]</td><td><code>tib01</code></td></tr>
<tr><td>Crypts [CEP]</td><td><code>tdc01</code></td></tr>
<tr><td>Deep Dungeon</td><td><code>isc01</code></td></tr>
<tr><td>Ruins</td><td><code>tdr01</code></td></tr>
</table></div><div style="margin-top:14px; padding:12px 14px; text-align:center; background:#120d10; border-top:1px solid #6f5730; color:#b7a995;">
[[Main Page|Return to Main Page]] · [[House Scripts]] · [[Custom Scripting]] · [[Your Resources]]
</div></div>[[Category:Player Tools]]
[[Category:Sinfar Supporters]]

Latest revision as of 14:04, 29 June 2026

NOTOC

PLAYER HOUSING

Building, exporting, uploading, and maintaining Sinfar player homes.

Player houses are custom-built interiors uploaded as ERF files. They must follow Sinfar housing limits, use approved tilesets, include a valid main door, and avoid restricted content such as unsupported creatures, items, merchants, or scripts.

Quick Index

Basic Guidelines
Minimum requirements, limits, and restricted content.

Acquiring a House
Finding a house sign and using the realtor.

Building Your House
Toolset setup, first area, ERF export, upload.

Using Scripts
Default scripts, approved scripts, custom scripting.

Builder Guide
External guide download.

Available Tilesets
Housing Interior, Exterior Wild/Rural, Misc, Exterior City/Town, Caves/Dungeons, Catacombs/Sewers, Barrows/Crypts/Ruins.

Basic Guidelines

Required
A player home must contain at least the following things:
  • 1 2x2 area made of one of the allowed tilesets.
  • A door with the tag MAIN_DOOR that will be used to leave the house.
  • Choose a specific loading screen.

The default loading screen is set to random, which is bad.

Allowed Building Options
You can then choose:
  • Area lightning
  • Ambient music
  • Placeables
  • Sounds
  • More doors
  • Waypoints
  • Triggers
  • Visual effects
  • More
Object Limits
Each area can have up to:
  • 1500 objects
  • 250 dynamic objects

A dynamic object is either:

  • A non-static placeable
  • A door
  • A trigger
  • A visual effect

Sinfar Supporters limit is twice that amount:

  • 500 dynamic
  • 3000 static

You may not put in your own items or creatures, or any merchants or scripts beyond those supported on Sinfar's houses script list page.

Acquiring a House

  1. Find a location: Player houses are characterized by a sign with a title such as "House #5", next to a door and the sign should say "For sale!" with the details on how the interior can be designed, for example:
  2. Go the the realtor: There's one for most islands or you can cheat and use the one in the OOC which is for all islands:

https://www.youtube.com/watch?v=2q-MsU8YXZ0

Example house sale signs.

Building Your House

Open the Editor

The interior of you house can be built using the Neverwinter Nights Toolset.

You can start building with this module:

Extract the module to your NWN\modules folder.

Extract the hak to your NWN\hak folder.

Create the First Area

Select one of the allowed tileset.

Select a size within the allowed range. The format on the deed is: Width x Height.

Add a door and set the tag to MAIN_DOOR.

This is the door that will be used to enter and leave the house, you don't have anything else to do, its transition will be setup automatically. It can have a custom appearance and the exterior door will be updated to have the same appearance.

Export the Area ERF(s)

Single-Area Home
If your home is a single area, you can simply right click on the area in the left hand menu and select 'Export Area', this will prompt you to save the .erf file ready for uploading.
Multi-Area Home
For a multi-area home you will need to use the resource exporter to create the ERF file of your areas:

With the editor open, open the File menu and select Export this will open a new window will open to 'Export Resources',

In the new window click 'Add Resources' which then opens up a new resource selection window,

If necessary at the bottom change the 'Resources of Type:' selector to 'Area File',

Select the areas you wish to export, and click 'Export' which will close the selctor dialog,

Once you have all the areas you wish to export listed, click 'OK' and you will be prompted to save the created '.erf' file.

After you have chosen the save filename and location you'll be prompted to add any comments to the ERF, you can click 'OK' again to leave the comments field empty.

You should now have your .erf file ready to be uploaded to the server.

Upload the ERF

Open the House Upload Page.

Enter your house ID and secret code, both can be found by examining your deed in game.

Select your house erf, it should be in your NWN\erf folder.

You can optionally compress it.

Click the Upload button.

The server will process your erf, validate all areas and strip everything that is not allowed and if everything goes well, you will get a message saying that your house is now in game.

Using Scripts

Default Scripts
Some objects will have a default scripts attached to them:

Plot placeable with an inventory will have a script to make their inventory persistent

Approved Scripts
You can use any of the scripts that are listed here: You can find more details here: Custom Scripting.

Approved Script RestrictionsYou can only use one script per object

When an object is using a script from this list, it will not have a default script, so for example, a plot placeable with an inventory won't be persistent if it is using one of those scripts.

Each script has a specific list of variable and any other variable name/type will be automatically removed

Make sure to read the script description, some require that placeable by dynamic, some can only be use a certain number of time...

How to Make Scripts, Dialogs, Creatures and Other Restricted Blueprints for inside Your House

The housing system is made so that you can even make your own scripts for inside your house and they will have no effect outside of it when ran. This feature is although restricted to selected players and Sinfar Supporters.

Read more here:

Sinfar Home Builders Guide

The Sinfar player home building guide may be found here:

Available Tilesets

The following tilesets are currently listed for player housing.

Housing Interior
NameTileset
Castle Interior 1 [CEP]tic01
Castle Interior 2tni02
City Interior 1 [CEP]tin01
City Interior 2tni01
Drow Interior [CEP]tid01
Elven Interiors, Marblebvi80
Elven Interiors, Woodenpie23
Fancy Castlefla01
Fort Interiortwc03
Gothic Interiorgi
Illithid Interiortii01
Medieval Keep Interiortei02
Modern Office Interiorsudp2
NWN2 Housestms02
Oriental Interiorori02
Sen's Rural Innsic11
Sigil, Stern Interior [CODI]thv01
SJ Wood Interiortis01
White Marble Castlembc30
Workshopwks01
Exterior Wild/Rural
NameTileset
Barren Landsisc03
Desert [CEP]ttd01
Desert, Babylon [CTP]tced0
Forest [CEP]ttf01
Frozen Waste [CEP]tti01
Medieval Foresttfm01
Rural Grass [CEP]ttr01
Rural Winter [CEP]tts01
Swamps [CEP]zkw01
Tropicalttz01
Urban Wastelandwlu01
Wild Woodsttw01
Wildlandstwl01
Wildlands Wintertwl02
Worms Cypress Bayouwcs10
Worms Dense Junglewdj01
Worms Desert Plainswdp01
Worms Fantasy Interiorswdd04
Worms Forest Summerwsf10
Worms Jungle Mountainstjj01
Worms Mirkwood Swampswms01
Worms Outer Limitswcc01
Worms Scorched Earthwlf01
Worms Underseawut01
Misc
NameTileset
Arenatte30
Future, Secret Basetcdh0
PHoD Bunker 1fifi1
PHoD Bunker 2fifi2
PHoD Bunker 3fifi3
PHoD Metal Vault Interiormbc31
PHoD Metal Wasteland 1tsr02
PHoD Vault - Ancientphodd
PHoD Vault - Exoticphoda
PHoD Vault - Lumpyphode
PHoD Vault - Murkyphodf
PHoD Vault - Strangephodb
PHoD Vault - Taintedphodc
Ship Interiornex01
Starship Interiorsshp02
Worms Wagon Travel Interiortms01
Exterior City/Town
NameTileset
Aztec Exteriortze01
Castle Exterior, Ruraltno01
City Exterior [CEP]tcn01
Complete Rural/Citytcr10
Elven Treetop Citythf02
Gothic Estatesgg
Medieval Citytcm01
Medieval Ruraltrm01
Modern Suburbsudp1
Oriental Ruralori01
Sigil, Exterior [CODI]tps01
Caves/Dungeons
NameTileset
Classic Dungeoncdlif
Dungeon [CEP]tde01
Dwarven Chasmsisc04
Eye of the Beholdertei01
Mines and Caverns [CEP]tdm01
Sea Cavestdt01
Sen's Icy Cavernssic01
Sen's Mines and Cavernsscv01
Sen's Underdarksdg01
Underdark [CEP]ttu01
Versatile Dungeontvd
Catacombs/Sewers
NameTileset
Catacombstwl04
Sewerstds01
Steamworkstsw01
Undercity Sewerisc02
Barrows/Crypts/Ruins
NameTileset
Barrows Interiortbw01
Beholder Interior [CEP]tib01
Crypts [CEP]tdc01
Deep Dungeonisc01
Ruinstdr01