EpicHuizen

Forward-EpicHuizen maakt van WorldGuard-regions panden die spelers huren of kopen bij een makelaar, met geld of munten uit het spel. Huurders betalen per week, kunnen weken vooruitbetalen, vrienden als bewoners toevoegen en opzeggen wanneer ze willen; kopers betalen één keer. Als een pand vrijkomt, wordt het precies teruggezet zoals het was, klaar voor de volgende.

Gemaakt door Forward Development voor Paper 26.2 en nieuwer. Standaard in het Nederlands; Engels of Duits kies je met één regel in de config.

Voor spelers

Huren bij de makelaar

Klik met rechts op een makelaar om alle panden van de server te zien: welke te huur zijn, wat ze per week kosten en wie de andere huurt. Klik op een pand, bevestig, en de eerste week wordt met je geld betaald. Je hebt nu toegang tot al zijn regions, ook kelders en extra verdiepingen.

Elke speler kan één pand tegelijk huren of bezitten. Heb je er al een, dan opent de makelaar je pandbeheer.

Kopen in plaats van huren

Een pand dat te koop staat, betaal je één keer. Daarna is het van jou, zonder einddatum en zonder waarschuwingen, tot je het opgeeft in het pandbeheer. Bewoners toevoegen werkt hetzelfde. Geef je het op, dan wordt het teruggezet zoals het bij de koop was; hoeveel je terugkrijgt, stelt de server in (standaard niets).

Pandbeheer

• Vooruitbetalen: betaal telkens één week extra, zolang er minder dan 12 weken over zijn (instelbaar).
• Bewoners: voeg tot 3 vrienden toe (instelbaar). Ze krijgen dezelfde toegang tot het pand als jij. Kies ze uit de spelers die online zijn; klik op een bewoner om hem te verwijderen.
• Opzeggen: stop met huren wanneer je wilt. Iedereen verliest meteen de toegang en het pand wordt teruggezet zoals het was. Opnieuw huren kan na een minuut (instelbaar).

Altijd weten waar je staat

• /pand toont je pand, de tijd die over is (bijvoorbeeld "2 weken, 3 dagen"), de einddatum en je bewoners.
• In de laatste 24 uur voor een huur afloopt, krijgt de huurder bij elke login een rode waarschuwing met de resterende tijd, en één keer als die periode begint terwijl hij online is. Daarin staat ook dat kisten geleegd worden als de huur afloopt.
• Een huurder die offline was toen zijn huur afliep, hoort het zodra hij terugkomt.
• /huurinfo opent de gegevens van het pand waar je staat.
• Wie een pand binnenloopt dat te huur is, ziet de naam en prijs in de chat.

Voor staff

Handleiding in het spel

/epichuizen help opent een menu dat stap voor stap uitlegt hoe je de plugin opzet en gebruikt, in vier hoofdstukken: opzetten, beheren, wat spelers kunnen en het terugzetten. Bij het opzetten zie je meteen wat al klaar is: de economie, je panden en je makelaars. Vanuit de handleiding maak je met één klik een pand, of open je het adminmenu, de blacklist of het makelaarsmenu. De uitleg gebruikt de instellingen van je eigen server, zoals het aantal weken vooruit en het aantal bewoners.

Een pand maken kost seconden

Ga in de region van het gebouw staan en gebruik /adminhuur. Klik op Nieuw pand: er opent een formulier waarin de region waar je staat al is ingevuld. Typ een naam (met &-kleurcodes, &#rrggbb-hexkleuren of MiniMessage), controleer de prijs en sla op. Klaar.

• Een pand kan meerdere regions hebben, bijvoorbeeld het huis, de kelder en de tuin. Cuboid- en polygon-regions werken allebei.
• Elk pand heeft zijn eigen prijs: geld, munten of allebei.
• Elk pand is te huur of te koop. Vink het aan in het formulier of gebruik /adminhuur settype <pand> huur|koop. Dat kan altijd; wie het pand nu heeft, houdt het.
• Elk pand krijgt een kort id voor commando's, zoals kerkstraat-12.

Panden beheren

Het menu van /adminhuur toont elk pand met status, huurder, einddatum, bewoners en regions. Klik er een aan om:

• de naam, regions en prijs te wijzigen;
• ernaartoe te teleporteren;
• de huurder gratis extra tijd te geven;
• de huur te beëindigen;
• het pand te verwijderen.

Bijna alles is ook een commando, dat ook vanuit de console werkt: create, rename, setprice, setcoins, settype, regions, extend, settime, end, info, list, delete, blacklist, unblacklist en munten. edit (het formulier) en tp hebben een speler nodig. Tab-aanvulling stelt pand-id's en vrije regionnamen voor.

De regions van een pand kunnen niet veranderen zolang het verhuurd is of wordt teruggezet, zodat een reset altijd de juiste plek terugzet.

Blacklist

Zet spelers die niet mogen huren op de blacklist: ze kunnen geen pand huren en niet als bewoner worden toegevoegd. Voeg ze toe en haal ze weg in het menu of met /adminhuur blacklist <speler> [reden] en /adminhuur unblacklist <speler>.

Makelaars

/adminhuur makelaar plaatst een makelaar waar je staat: een villager die niet beweegt en niet gewond, gehandeld, geduwd of veranderd kan worden. Gebruik je een NPC-plugin zoals Citizens? Kijk naar je NPC en gebruik /adminhuur makelaar link, dan werkt die ook als makelaar. NPC-plugins zonder echte entities (zoals FancyNpcs of ZNPCs) kunnen /adminhuur makelaar open {player} vanuit de console als klikactie gebruiken.

Het terugzetten

Als een huur afloopt, door opzeggen, verlopen of staff, wordt elke region van het pand teruggezet zoals hij was toen die huur begon: geplaatste blokken verdwijnen en gebroken blokken komen terug, ook in kelders en extra regions. Alleen de regions zelf worden aangeraakt, ook bij polygon-regions, dus buren merken er niets van. Losse items, minecarts, boten en leads die zijn achtergebleven worden verwijderd, en de schilderijen, lijsten en armor stands die er waren komen terug.

Met een reset kan niets gedupliceerd worden. Items in kisten, vaten, ovens en andere containers, in lijsten en op armor stands komen nooit terug, en loottables worden verwijderd. Items eruit halen en resetten geeft ze dus niet terug. Huurders krijgen een herinnering om hun spullen mee te nemen voordat de huur afloopt.

Blokken komen wel terug: bouw dus geen waardevolle blokken (ertsen, beacons) in een pand, want een huurder zou ze elke huurperiode één keer kunnen afbreken.

Het terugzetten werkt met WorldEdit of FastAsyncWorldEdit en schrijft alleen de blokken die veranderd zijn, dus een normaal gebruikt huis is in een oogwenk terug. Het wordt op schijf bewaard en afgemaakt na een herstart, of zodra de wereld laadt, als de server tussendoor stopte. Resets lopen na elkaar, zodat veel huren die tegelijk aflopen de server niet laten haperen. Heel grote panden (meer dan 500.000 blokken, instelbaar) kunnen gewoon gehuurd worden, maar worden niet teruggezet.

Geld en munten

Elk pand heeft zijn eigen prijs per week, in geld, in munten of allebei: bijvoorbeeld 25000, of 5 munten, of 25000 en 5 munten. Beide op 0 maakt een gratis pand.

• Geld gaat via elke economie die met Vault werkt, zoals EssentialsX.
• Munten zijn een item: een glanzend goudklompje met een eigen naam, stapelbaar tot 64. Spelers betalen ze uit hun inventory bij de makelaar. Staff maakt munten met /adminhuur munten <speler> <aantal>, ook vanuit de console, zodat crates, quests of een shop ze als beloning kunnen geven. Het item, de glans en een eigen model uit een resourcepack stel je in.
• Munten zijn beschermd tegen dupen en kwijtraken: alleen munten met het juiste kenmerk tellen (een goudklompje met dezelfde naam niet), ze kunnen niet in crafting, een aambeeld, oven of brouwstandaard, niet geplaatst of gebruikt worden en niet door mobs worden opgepakt.

De betaling wordt afgeschreven voordat het pand wordt gegeven, een betaling die mislukt kost niets, twee keer klikken betaalt niet twee keer, en een speler betaalt altijd de prijs die hij op het bevestigingsscherm zag. Betaalde weken worden bij opzeggen niet terugbetaald; het bevestigingsscherm zegt dat erbij.

PlaceholderAPI

Met PlaceholderAPI (optioneel) toon je pandgegevens op scoreboards, in de tab-lijst of in chat. De waarden worden elke seconde bijgewerkt:

• %epichuizen_pand%, %epichuizen_pand_id%: het eigen pand (gehuurd of gekocht) en zijn id.
• %epichuizen_has_pand%, %epichuizen_owned%: of de speler een pand heeft, en of het gekocht is.
• %epichuizen_type%: huur of koop.
• %epichuizen_time_left%, %epichuizen_until%: de tijd die over is en de einddatum ("voor altijd" bij een gekocht pand).
• %epichuizen_price%: de prijs van het eigen pand, met "per week" of "eenmalig".
• %epichuizen_residents%, %epichuizen_resident_count%: de bewoners en hoeveel het er zijn.
• %epichuizen_home%: het pand waar de speler woont, als huurder, eigenaar of bewoner.
• %epichuizen_coins%: hoeveel munten de speler bij zich heeft.
• %epichuizen_here%, %epichuizen_here_status%, %epichuizen_here_price%: het pand waar de speler nu staat, de status en de prijs.
• %epichuizen_available%, %epichuizen_for_sale%, %epichuizen_total%: hoeveel panden te huur en te koop zijn, en hoeveel er in totaal zijn.

Alles is aan te passen

• Taal kiezen met één regel: zet language in config.yml op nl, en of de en gebruik /epichuizen reload. Een eigen taal maak je door een taalbestand te kopiëren en de naam in te vullen.
• Elke tekst staat in het taalbestand (languages/nl.yml, en.yml of de.yml), elk bericht op een eigen regel met MiniMessage, zodat je elk woord en elke kleur kunt aanpassen. Menutitels, itemnamen en lore, formulieren, de naam van de makelaar, tijdseenheden, de datumnotatie en de commando-omschrijvingen staan er allemaal in.
• config.yml heeft boven elke optie een uitleg: weken vooruit, bewoners, de waarschuwing bij inloggen, de melding bij binnenlopen, het terugzetten, het uiterlijk van de makelaar, menu-items en geluiden.
• Zes kleurthema's: forward (blauw), crimson, emerald, amber, amethyst en mono, of maak je eigen.
• De naam in het chatvoorvoegsel en de menu's is één regel in config.yml.
• /epichuizen reload past je wijzigingen toe zonder herstart.
• Bij een update worden nieuwe opties en berichten automatisch aan je bestanden toegevoegd. Je eigen instellingen worden nooit overschreven.
• Een fout in een bestand wordt in de console gemeld, met de waarde die in plaats daarvan wordt gebruikt. Een kapot bestand wordt nooit vervangen of leeggemaakt.

Veilig op een openbare server

• Menu's zijn alleen-lezen. Er kan niets uit of in een menu worden gezet, met geen enkele klik, toets of sleepbeweging.
• Geen dubbele betalingen. Elke betaling wordt in één stap gecontroleerd en afgeschreven.
• Huren en bewoners volgen WorldGuard. Huurders en bewoners zijn member van de regions; niemand anders krijgt toegang. Als een huur afloopt, wordt de toegang weer weggehaald, ook als de server direct daarna crashte of de wereld niet geladen was.
• Geplaatste makelaars kunnen niet gedood, geduwd, verhandeld of in een heks veranderd worden.
• Je data is veilig. Panden worden opgeslagen in data.yml met een back-up van de vorige keer opslaan. Raakt het bestand ooit beschadigd, dan wordt de back-up geladen en blijft het beschadigde bestand bewaard zodat je ernaar kunt kijken.

Commando's en permissies

epichuizen.* geeft alle permissies. Staff met epichuizen.admin ziet in /huurinfo ook de huurgegevens van elk pand.

Vereisten

• Paper 26.2 of nieuwer, of een fork van Paper zoals Purpur.
• Java 25.
• Vault met een economieplugin, zoals EssentialsX.
• PlaceholderAPI (optioneel), voor placeholders.
• WorldGuard 7.0.19 of nieuwer en WorldEdit 7.4 of nieuwer, of FastAsyncWorldEdit 2.15 of nieuwer.
• Een licentiesleutel van Forward Development. De server heeft bij het starten internet nodig om die te controleren.

Spigot, CraftBukkit en Folia worden niet ondersteund. De plugin gebruikt functies die alleen in Paper bestaan.

Formulieren voor staff openen als dialoogvenster, dat Java Edition als formulier toont. Staff op Bedrock kan in plaats daarvan de /adminhuur-commando's gebruiken.

Goed om te weten

• Een pand is een set WorldGuard-regions. Maak eerst de regions met WorldEdit en /rg define, en maak er dan een pand van.
• Een region kan maar bij één pand horen, en alle regions van een pand liggen in dezelfde wereld.
• De plugin bewaart op je server, in plugins/Forward-EpicHuizen/data.yml: de id's en namen van huurders, bewoners en spelers op de blacklist, redenen voor de blacklist met wie ze toevoegde en wanneer, en een korte melding voor huurders van wie de huur afliep terwijl ze offline waren. Opgeslagen regions staan in snapshots/ tot de huur afloopt. Er wordt niets over spelers ergens naartoe gestuurd.
• Updaten doe je door de jar te vervangen en de server te herstarten. Plugins herladen terwijl de server draait wordt niet ondersteund.

Support

Vragen of problemen: support@fwdscripts.com. Stuur de uitvoer van /epichuizen info mee, je Paper-versie en het stuk van de console met de fout.

Licentievoorwaarden

Betaald of gratis: je licentie laat je de plugin op één server tegelijk gebruiken met je eigen licentiesleutel. Je mag de sleutel of de plugin niet delen, doorverkopen of de licentiecheck verwijderen of omzeilen. De licentiecheck stuurt de sleutel, een server-id, de pluginversie en het IP-adres van de server naar Forward Development, alleen om de licentie te controleren en misbruik op te sporen. De volledige voorwaarden staan in EULA.txt, dat bij de plugin zit (in het Engels; de Engelse tekst is geldig). Vragen: legal@fwdscripts.com

Forward-EpicHuizen is geen officieel Minecraft-product en is niet goedgekeurd door of verbonden aan Mojang of Microsoft.

Installatie

1. Installeer Vault, een economieplugin zoals EssentialsX, WorldEdit (of FastAsyncWorldEdit) en WorldGuard.
2. Zet de Forward-EpicHuizen-jar in je map plugins.
3. Start de server één keer, zodat de config wordt aangemaakt.
4. Zet je licentiesleutel achter private-key bovenaan plugins/Forward-EpicHuizen/config.yml.
5. Kies je taal met de optie language, en pas de rest van config.yml, je taalbestand in languages en het thema naar wens aan.
6. Herstart de server.
7. Open /epichuizen help en volg de stappen onder Opzetten: regions maken, je eerste pand en een makelaar.

Een licentiesleutel werkt op één server tegelijk. Wil je hem naar een andere server verhuizen, stop dan eerst de oude. Is de oude server gecrasht, dan is de sleutel na een paar minuten weer vrij.