# AwesomeHouses<\/p>\n
AwesomeHouses links AwesomeTaxes regions and AwesomeKeycards locks into a single house-buying workflow. Staff publish houses on signs with a sale price; players right-click to pay, become the owner in AwesomeTaxes, receive a personal keycard, and all doors\/containers inside the region are auto-locked to that card.<\/p>\n
**Version:** 1.0.0
\n**Requires:** AwesomeTaxes + AwesomeKeycards (APIs provided via Bukkit services)<\/p>\n
## Highlights ## Quick Start ## Full Workflow (Step-by-Step) ## Commands ## Permissions ## Storage wesomeHouses links AwesomeTaxes regions and AwesomeKeycards locks into a single house-buying workflow.<\/p>\n","protected":false},"featured_media":24199,"template":"","meta":{"_minecraft_slug":"awesomehouses","_minecraft_project_id":"1tNg6s5G","_minecraft_author":"NeonDev","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"awesomehouses.zip","_minecraft_size_bytes":1711597,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:50:42.563860Z","_minecraft_date_created":"2025-12-13T01:08:29.705988Z","_minecraft_date_modified":"2025-12-06T21:03:27.921057Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/awesomehouses","_minecraft_icon_attachment_id":24199,"_minecraft_imported_at":"2026-06-01T08:13:37+00:00","_minecraft_import_hash":"010383e3304de67e9c273e9f22b67bdc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127,867,92],"mod_loader":[132],"minecraft_version":[81],"class_list":["post-24198","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21-8"],"yoast_head":"\n
\n– Sign-based listings: `\/houses create
\n– Automatic region scan: reuses AwesomeKeycards lockable logic to detect doors\/containers\/buttons inside the AwesomeTaxes region.
\n– One-key protection: buyer gets a personal keycard; every detected lockable block is linked to that single card.
\n– Taxes integration: ownership is assigned via `TaxesAPI` to the specified AwesomeTaxes house ID.
\n– Simple payments: player right-clicks the sign holding the required item stack; payment is removed, ownership and locks are applied, and the card is given.<\/p>\n
\n1) Create a house in AwesomeTaxes and note its ID (e.g., `H-001`).
\n2) As staff with `awesomehouses.staff`, hold the payment item stack (amount = sale price), look at a sign, and run:
\n `\/houses create H-001
\n The sign updates to `[FOR SALE]` with listing ID, price, and tax ID.
\n3) Player purchase: right-click the sign with the required items in hand. They pay, receive a personal keycard, become the house owner in AwesomeTaxes, and all detected lockable blocks in the region are protected to that card. The sign flips to `[OWNED]`.<\/p>\n
\n1) Define the region in AwesomeTaxes
\n – Staff selects corners with `\/taxes pos1` and `\/taxes pos2` (same world).
\n – Create the house region: `\/taxes create
\n – (Optional) View details: `\/taxes info H-001` or list via `\/taxes myhouses`.
\n2) Configure the tax payment in AwesomeTaxes
\n – Hold the required payment item stack (stack size = amount) in your main hand.
\n – Run `\/taxes admin setitem H-001` to save the tax item\/amount for that house.
\n – (Optional) Add members in Taxes if you want pre-owners: `\/taxes addmember H-001
\n3) Publish a sale sign with AwesomeHouses
\n – Stand anywhere, look directly at a sign block.
\n – Hold the payment item stack you want to charge for the purchase (stack size = sale price).
\n – Run `\/houses create H-001
\n – AwesomeHouses will:
\n – Pull the region from AwesomeTaxes (house `H-001`).
\n – Scan that region for lockable blocks using the AwesomeKeycards logic (doors, trapdoors, fence gates, buttons, levers, chests, barrels, furnaces, shulkers, hoppers, dispensers, droppers).
\n – Save a listing with a new listing ID and update the sign to:
\n “`
\n [FOR SALE]
\n Casa #
\n “`
\n4) Player purchase flow
\n – Buyer right-clicks the sale sign while holding the exact required item stack (same material as price item, amount \u2265 price).
\n – AwesomeHouses will:
\n – Remove the payment items from the player\u2019s hand.
\n – Create a personal keycard labeled with the listing ID.
\n – Assign ownership in AwesomeTaxes via TaxesAPI: `H-001` owner becomes the buyer.
\n – Lock every detected lockable block in the region to that keycard (one key controls everything).
\n – Deliver the keycard to the player (drops on ground if inventory is full).
\n – Update the sign to:
\n “`
\n [OWNED]
\n Casa #
\n5) Post-purchase behavior
\n – The buyer (new owner) is now the Taxes owner and holds the only keycard that opens all doors\/containers in the region.
\n – Any additional locks in that region can be relinked manually with the same card if desired.
\n – Admins can still manage ownership in Taxes (`\/taxes admin setowner`) or revoke\/add members; locks remain tied to the keycard.<\/p>\n
\n– `\/houses create
\n Permission: `awesomehouses.staff` (default: op)<\/p>\n
\n– `awesomehouses.staff` \u2013 create\/manage listings (publish signs). Default: op.<\/p>\n
\n– Listings are stored in `plugins\/AwesomeHouses\/listings.yml` (region, price item, sign location, lock targets, and owner when sold).<\/p>\n","protected":false},"excerpt":{"rendered":"