Tags:

Utility

Author:

Maz

Side:

Both

Created:

Oct 2nd at 11:29 PM

Last modified:

4 days ago

Downloads:

427

Recommended download (for Vintage Story 1.22.0 - 1.22.7):
ContratsGages_v1.0.17.zip  1-click install

Mod crée pour le serveur francais   Vintage RôlePlay - Chapitre 1 : Prima Insula, Rejoignez nous !

English

Player-made contracts, nailed to Notice Board boards, with real rewards held in escrow. A client writes a contract and pledges the reward. A worker takes the paper, does the job and gets paid at the board or in person. Made for immersive roleplay servers, for Vintage Story 1.22.7. First public release: feedback is welcome.

Highlights

• A town crier on Discord. Every contract gets its own forum thread with a live notice (status, request, reward, places, deadline in game and real time), and news as it happens: places taken, tally marks, receipts with the client's appreciation, the crier's last-day reminder. A daily Counter Gazette sums up the finest rewards, contracts about to expire and the journeymen of the day. Optional staff and treasury channels. Webhooks only: no bot to host.
• A physical Crown treasury. A Treasury chest holds the public money (its access follows land claims: guard it well), players slide taxes and donations into an offering box they cannot open, and an account book records every coin in and out. Crown contracts are paid from the chest, and unearned pay goes back to it.
• Orders of several items. Up to 6 different items in one order (a saw, a shovel, 20 planks…), each with its quantity. Delivery is all or nothing, and the contract tells you what is missing.
• A real coin purse. With Salary Coin 2, pledges, rewards and refunds go through the purse, appear in its statement, and reach players even while they are offline. Without it, pay is made with coins or any items you choose, with change given back.

The spirit

• No money out of thin air. The reward leaves the client's bags or purse when the contract is sealed, and goes to the worker on settlement. Unearned rewards go back to the client (or to the treasury) at the deadline.
• Everything happens in the world. No global quest menu and no chat spam: contracts are found on boards, carried as papers and honoured face to face.
• Every paper has a role. Contract form, contract, stub, receipt, journeyman's booklet and account book.
• Server and client: install it on the server; players download it automatically when they join.

How it works

1. Write. Craft a contract form (parchment and beeswax). Hold ink and quill in your left hand and use the form on, or next to, a notice board. The writing desk shows a live preview of the notice and lists what is still missing. Search items with several words ("oak plank", "antler moose") and page through every result.
2. Post. Seal and post: the reward goes into escrow and the sheet is nailed to the board, with a header for the kind of contract and your trade, the requested items with their icons, the reward, the free places and the deadline. You keep the stub.
3. Take. Open the board, click Read contract, then Take this contract. The sheet leaves the board and the contract lands in your bags.
4. Honour. At the board, open your contract and click Deliver or Claim the reward. In person, the client opens the stub next to you and proposes the settlement; you accept with Shake on it! and the exchange is simultaneous.
5. Afterwards. The worker gets a signed receipt, collected in a journeyman's booklet that anyone can read: a reputation without levels or XP.

Four kinds of contract

• Order: up to 6 different items, each with its quantity, exact variant or any variant.
• Hunting bounty: N creatures of a species, counted as tally marks on the paper once the contract is taken.
• Expedition: reach a place; the map waypoint is attached to the notice.
• Work: a free task described in the notice, judged by the client and settled in person.

A contract can have several places ("5 lots of 20 charcoal"): each worker takes one paper, and escrowed items are split evenly between places.

For server staff

• Crown contracts: in the name of an institution ("By order of the Council of…"), signed with the name of the Treasury chest that pays them.
• Disputes: either party can call a GM. The place is frozen until the staff settles or refunds it.
• Registry: /contrat registre lists every contract by tab, with a journal for each one.
• Commands, also from the console: /contrat liste, voir, regler, rembourser, annuler, prolonger, tresor. Privilege: contratsmj (admins always have it).
• Configuration in ModConfig/contratsgages.json: limits, durations, reach, ink and quill, notifications, currency, treasury, Discord (webhooks, gazette hour, worker names, real-time deadlines, reminders).

Requirements

• Notice Board 3.0.3 or later (required; tested with 3.0.4)
• Attribute Rendering Library 3.2.0 (required by Notice Board)
• Optional: Salary Coin 2.0 for the purse, AnyCoin for coins. Without them, rusty gears are the default currency.

Known limitations

• The mod uses Notice Board's public classes (tested with 3.0.3 and 3.0.4): a future Notice Board update may require an update of this mod.
• Hunting bounties count the player who lands the killing blow.
• With a cartography mod such as Mapper, an expedition place can only be marked on a charted area. This is intended.
• Discord: a webhook cannot rename a thread or change its tags, so a contract's state is read in its notice. Set the forum's "Hide after inactivity" to one week.

English and French, with a guide in the handbook. Notice Board by propaneko, Attribute Rendering Library by DanaCraluminum, AnyCoin by Vyp3rG0d; no files from these mods are included. Contrats & Gages is under the MIT license.

---

Français

Des contrats entre joueurs, cloués aux tableaux de Notice Board, avec une prime réellement mise en gage. Le commanditaire rédige un contrat et met la prime en gage. Le travailleur prend le papier, fait le travail et se fait payer au tableau ou en main propre. Pensé pour les serveurs RP immersifs, pour Vintage Story 1.22.7. Première version publique : vos retours sont les bienvenus.

Les nouveautés

• Un crieur public sur Discord. Chaque contrat a son fil de forum avec une annonce vivante (statut, demande, prime, places, échéance en jeu et en temps réel) et ses nouvelles au fil de l'eau : places prises, encoches de chasse, quittances avec l'appréciation du commanditaire, rappel du crieur la veille de l'échéance. Chaque jour, la Gazette du Comptoir présente les plus belles primes, les contrats bientôt échus et les compagnons à l'honneur. Salons staff et trésorerie en option. Uniquement des webhooks : aucun bot à héberger.
• Un trésor de la Couronne physique. Un Coffre du Trésor contient l'argent public (son accès suit les claims : gardez-le bien), les joueurs glissent impôts et dons dans un tronc qu'ils ne peuvent pas ouvrir, et un livre de comptes garde la trace de chaque pièce. Les contrats de la Couronne sont payés par le coffre, et ce qui n'est pas gagné y retourne.
• Des commandes de plusieurs objets. Jusqu'à 6 objets différents dans une commande (une scie, une pelle, 20 planches…), chacun avec sa quantité. La livraison se fait en une fois, et le contrat dit ce qui manque.
• Une vraie bourse. Avec Salary Coin 2, mises en gage, primes et remboursements passent par la bourse, s'inscrivent à son relevé et arrivent même aux joueurs déconnectés. Sans elle, on paie en pièces ou avec les objets de votre choix, avec rendu de monnaie.

L'esprit

• Aucun argent n'est créé. La prime quitte le sac ou la bourse du commanditaire au moment où il scelle le contrat, et va au travailleur au règlement. Une prime non gagnée revient au commanditaire (ou au trésor) à l'échéance.
• Tout se passe dans le monde. Ni menu global, ni messages en rafale : on trouve les contrats sur les tableaux, on les emporte sous forme de papier et on les honore en personne.
• Chaque papier a un rôle. Formulaire, contrat, souche, quittance, livret de compagnon et livre de comptes.
• Serveur et client : à installer sur le serveur ; les joueurs le téléchargent automatiquement en se connectant.

Comment ça marche

1. Rédiger. Fabriquez un formulaire de contrat (parchemin et cire d'abeille). Tenez une plume et de l'encre dans la main gauche, puis utilisez le formulaire sur un tableau ou à côté. L'écritoire montre l'aperçu de l'annonce en direct et la liste de ce qui manque encore. Cherchez les objets avec plusieurs mots (« planche chêne », « ramure cerf ») et parcourez tous les résultats par pages.
2. Afficher. Sceller et afficher : la prime est mise en gage et la feuille est clouée au tableau, avec l'en-tête de la nature du contrat et votre qualité, les objets demandés avec leurs icônes, la prime, les places libres et l'échéance. Vous gardez la souche.
3. Prendre. Ouvrez le tableau, cliquez sur Consulter le contrat, puis sur Prendre ce contrat. La feuille quitte le tableau et le contrat arrive dans votre sac.
4. Honorer. Au tableau, ouvrez votre contrat et cliquez sur Livrer au tableau ou Toucher la prime. En main propre, le commanditaire ouvre sa souche à côté de vous et vous propose le règlement ; acceptez avec Topez là ! et l'échange est simultané.
5. Après. Le travailleur reçoit une quittance signée, rassemblée dans un livret de compagnon que chacun peut lire : une réputation sans niveaux ni XP.

Quatre natures de contrat

• Commande : jusqu'à 6 objets différents, chacun avec sa quantité, variante exacte ou toutes variantes.
• Prime de chasse : N bêtes d'une espèce, comptées en encoches sur le papier une fois le contrat pris.
• Expédition : se rendre à un lieu ; le repère de carte est joint à l'annonce.
• Ouvrage : un travail libre décrit dans l'annonce, jugé par le commanditaire et réglé en main propre.

Un contrat peut avoir plusieurs places (« 5 lots de 20 charbons ») : chaque travailleur prend un papier, et les objets du gage sont partagés également entre les places.

Pour le staff

• Contrats de la Couronne : au nom d'une institution (« Par ordre du Conseil de… »), signés du nom du Coffre du Trésor qui les paie.
• Litiges : chaque partie peut saisir un MJ. La place est gelée jusqu'à ce que le staff la règle ou la rembourse.
• Registre : /contrat registre liste tous les contrats par onglet, avec le journal de chacun.
• Commandes, aussi depuis la console : /contrat liste, voir, regler, rembourser, annuler, prolonger, tresor. Privilège : contratsmj (les admins l'ont toujours).
• Configuration dans ModConfig/contratsgages.json : limites, durées, portées, plume et encre, notifications, monnaie, trésor, Discord (webhooks, heure de la gazette, noms des travailleurs, échéances en temps réel, rappels).

Prérequis

• Notice Board 3.0.3 ou plus (requis ; testé avec la 3.0.4)
• Attribute Rendering Library 3.2.0 (requis par Notice Board)
• Facultatif : Salary Coin 2.0 pour la bourse, AnyCoin pour les pièces. Sans eux, la monnaie par défaut est la roue dentée rouillée.

Limites connues

• Le mod s'appuie sur les classes publiques de Notice Board (testé avec la 3.0.3 et la 3.0.4) : une future mise à jour de Notice Board pourra demander une mise à jour de ce mod.
• Les primes de chasse comptent le joueur qui porte le coup fatal.
• Avec un mod de cartographie comme Mapper, un lieu d'expédition ne peut être marqué que sur une zone cartographiée. C'est voulu.
• Discord : un webhook ne peut ni renommer un fil ni changer ses étiquettes ; l'état du contrat se lit dans son annonce. Réglez « Masquer après inactivité » du forum sur une semaine.

Français et anglais, avec un guide dans le manuel. Notice Board par propaneko, Attribute Rendering Library par DanaCraluminum, AnyCoin par Vyp3rG0d ; aucun fichier de ces mods n'est inclus. Contrats & Gages est sous licence MIT.