UnturnedForge Marketplace

A massive, fully automated, and highly optimized physical real estate ecosystem for Unturned.

VortixHousing is a massive, fully automated, and highly optimized physical real estate ecosystem for Unturned. Players can interact with physical signs in-game to purchase property, manage virtual stashes, pay rent via Uconomy, and much more.

✨ Features

Physical Real Estate: Players purchase houses by walking up to a physical [FOR SALE] sign and punching it.
Automated Locking: Ownership of doors (main and secondary) and furniture is automatically stripped and locked when a house goes on sale, and natively transferred to the buyer upon purchase.
Dynamic Signs: Signs dynamically update with rich-text colors to display sale prices or owner names and rent due dates. Signs are permanently locked from vandalism.
MySQLVault-Style Virtual Stash: Players can access an invisible, infinite storage crate spawned underground (/stash <id>) that serializes perfectly back to the database.
Uconomy Integration: Rent and purchases use Uconomy. Transactions run on background threads for 0 server lag.
Automated Evictions: A background task automatically monitors rent payments and inactivity, evicting players and putting their house back on the market.
Discord Webhooks: Fully customizable, color-coded Discord embeds alert your server when a house is created, bought, sold, or evicted.
Dual Database Support: Works out of the box with LiteDB (local) or can connect to a remote MySQL server.
Friend Sharing: House owners can add friends to share stash access and property rights.
Invulnerability: The plugin natively intercepts damage events to prevent players from blowing up sale signs and structures.

🛠️ Commands & Permissions

Player Commands

Command	Description	Permission
`/house sell <id>`	Sells the house back to the market for a percentage of the original price.	`house.sell`
`/house payrent <id>`	Pays 1 day of rent via Uconomy.	`house.payrent`
`/house addfriend <id> <player>`	Adds a player to the house friends list.	`house.addfriend`
`/house removefriend <id> <player>`	Removes a player from the house friends list.	`house.removefriend`
`/house checkfriends <id>`	Lists all friends currently added to the house.	`house.checkfriends`
`/stash <id>`	Opens the virtual stash for the house (Must be near the main door).	`house.stash`

Admin Commands

Command	Description	Permission
`/createhouse <price>`	Creates a new house starting at the main door you are looking at.	`house.admin.create`
`/addsalesign <id>`	Links a sign you are looking at to the house, making it the purchase point.	`house.admin.addsalesign`
`/addsecondarydoor <id>`	Links an additional door to the house for ownership transfers.	`house.admin.adddoor`
`/checkhouse`	Look at a door or sign to see which House ID it belongs to.	`house.admin.check`
`/evicthouse <id>`	Forcefully evicts the current owner.	`house.admin.evict`
`/deletehouse <id>`	Completely deletes a house from the database.	`house.admin.delete`
`/findplayerhouses <player>`	Lists all houses owned by a specific player.	`house.admin.findplayerhouses`

Note: Admins can bypass limits using house.admin.override.

⚙️ Configuration

When you first run the plugin, VortixHousingConfiguration.xml will generate. Key settings include:

DatabaseType: Set to LiteDB (default) or MySQL.
MarketSaleTaxPercentage: Percentage lost when a player sells a house back.
EnableRentSystem: Toggle the daily rent system.
RentDailyCost: The Uconomy cost per day for rent.
MaxFriendsPerHouse: The maximum number of friends a player can add to a house.
DiscordWebhookUrl: Paste your Discord Webhook URL here to enable embeds.
DiscordWebhookUsername / DiscordWebhookAvatarUrl: Customize your bot's branding!

🏗️ Step-by-Step: Setting Up a House In-Game

Setting up a house is extremely easy and requires placing objects in-game first.

Place the Main Door: Build or place a door that acts as the primary entrance to the house.
Create the House Database Entry:
- Look directly at the main door.
- Type /createhouse <price> (e.g., /createhouse 5000).
- The plugin will register the door, assign it a unique House ID, and give the property a randomized name (e.g., "Emerald Estate").
Link Additional Doors (Optional):
- Look at any other doors (back doors, garage doors) that belong to the property.
- Type /addsecondarydoor <HouseID>.
Place & Link the Sale Sign:
- Place a standard sign (e.g., ID 1098) outside the house where players can easily see it.
- Look directly at the sign.
- Type /addsalesign <HouseID>.
- The plugin will instantly lock the sign, change its text to a bright red/green [FOR SALE] tag with the price, and lock all doors to secure the property!
Done! A player can now walk up to the sign and punch it to purchase the house!

VortixHousing