v0.5.0 · neoforge 1.21.1
Curse Maven Snippet
What's new
One release for STYGION: Aeronautics 1.2: a bank for the server's coins, quests that pay into it, K redone around cards, zone effects you earn, and the ore world on a generator of its own.
The bank and unlocks
A bank for the server's coins, and zone effects you earn: a rank, a boss, and one payment.
The bank (module
bank, off by default): every player has an account in the server's own coins (bank.coins, the same lines as plots and crates)./bankshows it,/bank depositputs the coins you carry on it,/bank withdraw <amount>pays them out (2sealasks for that coin),/bank historylists what happened./pay <player> <amount>sends money to anybody, online or away (a name two accounts have carried is refused, never guessed), withbank.transfer-feepercent leaving the economy. Every change is a line in a ledger.Paying draws on the account: plots, zone unlocks and Create shops take what the pocket lacks from the account (
bank.pay-order: pocket-first, bank-first or bank-only). At a Create shop the missing coins are taken just before the Stock Keeper counts the payment - after it checked its stock, so nothing goes for a purchase that cannot happen (bank.create-shops). A plot's seller is paid onto their account, even when away. Coins from crates go onto the account withbank.crates-to-bank.The editor's Bank screen: every account, all the money on accounts, the ledger, and adding to or taking from an account with a reason the player reads (
POST /v1/bank/adjust, an owner's key only - it makes or destroys money).GET /v1/bank,/v1/bank/history,/v1/bank/ledgerread (bank.read, an owner's key only too: everybody's wealth, and plot lines name the chunks bought).Who may use it:
/bankneedskeystone.bankand/payneedskeystone.bank.pay; thedefaultgroup gets both, so a server that wants accounts without transfers between players takes the second away.Money is neither lost nor made on the way: both sides of a
/payare one change and one database transaction; coins are only taken for a deposit the account can take, and a withdrawal is worked out in coins before the account is touched - an amount no coin makes is refused, and coins that cannot be handed over go back onto the account. A withdrawal hands over at most an inventory of coins (2304) at once. A write the database refuses is kept and tried again, and named in the log at stop if it never went through. A seller, a crate or a refund the account cannot take is paid in coins (or owed) as without a bank.After a crash, the account matches the inventory again: a server that dies without saving comes back with the world at its last save, and the accounts are not rolled back with it. Every exchange of coins between an inventory and the bank (deposit, withdraw, a Create shop's top-up, coins paid from the pocket for a plot or an unlock) is numbered in the player's own saved data, and at their next join the exchanges that saved data never saw are put right, once. A deposit whose coins came back is taken off the account (
bank.crash-revert.take-back,onorlog-only), as a ledger linecrash-revert; an account never goes below nothing, and what was already spent is named in the log as owed. A withdrawal whose coins may be lost waits for you (bank.crash-revert.give-back,log-onlyby default): coins handed to somebody, put in a chest or dropped before the crash still exist, the bank cannot tell, and giving money back on its own word would let a player who can crash a server copy coins. It is named in the log and the ledger (crash-waiting) and listed on the editor's Bank screen and under/bank waiting, where the owner gives it back or dismisses it (POST /v1/bank/waiting).ongives it back at once. And the bank writes a player's own data a second after it hands them coins - one small write for everything handed over in that second, nothing of the world - so a withdrawal can only be caught unsaved in that second./bank historyin coins and in your language: a payment out reads-7× Ember Hex + 6× Obollike a deposit (it was a bare-62), and what each line was (deposit, withdrawal, sent, received, quest reward ...) is a translated word (bank.kind.*,bank.history-line).The bank's and the unlocks' settings are the owner's: what a coin is, the fee, the payment order, an unlock's price and the two settings above can be written in the game only by the owner, like plots' coins - not by a group that holds
keystone.settings.write. The same now forplots.player-sales.feeandcrates.items.A paid unlock is not lost to a write that failed: kept, tried again with later writes and at stop, and named in the log if it never goes through.
For addons:
Player.savedNumber/saveNumberkeep a whole number in a player's own saved data, written with their inventory;Player.save()writes that data now.A name means one account:
/pay Annagoes to whoever is online under exactly that name; otherwise everybody the name could mean, letter case aside, has to be one account - on a server that does not ask Mojang,Annaandannaare two people, and the one who happens to be online is not paid in the other's place.Held means held: somebody who has not proved who they are yet (the accounts module) could still press buttons of the K menu through the mod's own channel; nothing but the client's hello is heard from them now.
The exchange module is gone: the bank does what it was for.
A banker standing in the world (
bank.banker.place,.entity,.name,.data; none by default): one entity at one place - any kind, a villager librarian by default - that a right click turns into the bank: K → Bank with Keystone on the client, the balance and the commands in chat without. It does nothing else: no trades, no AI, no damage, no lead or name tag, and a mod that picks villagers up through the click never hears it. While its chunk is loaded Keystone keeps it: a missing one comes back, a second copy goes, a moved one is put back (nothing is loaded for it). Emptyingbanker.placeremoves it. It replaces the KubeJS banker STYGION MC had.A wrong link code is a 400, not a 500:
POST /v1/links/redeemanswers a wrong or spent code and a key over its limit ("too many wrong codes") with the reason, so a website can tell the player the code is wrong; the same for unknown names, ids and sources on/v1/badges/give,/v1/import/run,/v1/loaded/release,/v1/worlds/reset,/v1/profiler/reportand an unreadablesinceon the milestones list.Unlocks (
territory.unlocks): an effect a zone gives can need unlocking first — a rank (any of the listed groups, so playtime ranks open it for everybody and paid ranks earlier), a boss killed (the game's own statistic, any of a list; severalkilled=words must all hold) and a price paid once in the server's coins (unlocks-coins, the same lines as plots and crates;paid-priceforunlocks-paid-groups, change given back)./zone unlock <effect>, and an Unlock button in K → Settings → Places that says what is still missing. An effect with no unlock line stays free.A zone rule with
unlocked=holdergives an effect only on the land of a team where somebody unlocked it — for its members and allies there;unlocked=selfonly to who unlocked it.
Quests that pay
Quests that pay: a week between the day and the month, rewards that are worth playing for, chapters of a quest book, and none of it for alt accounts or AFK farms.
- A week of quests (module
quests):weekly.count,weekly.questsandweekly.all-donebeside the day and the month, starting onweek-startsatreset-at; the goal for people who do not play every day.weekly.count = 0turns it off./quests, the quest screen andGET /v1/questsshow it. - Coins as a reward:
coins 64(in the smallest coin) orcoins 2sealgo straight onto the bank account with a line in the bank's ledger (kindquest) - never as items. A line that pays coins is left out of its pool, with the reason in the log, while the bank module is off. Extra claims are a rank thatterritory.earnedgives chunks to. - Every reward is written before it is handed over, in the module's own ledger (
quests_paid): one payout per player and quest, set or streak, so a quest finished again after a crash or an admin's reset the same day pays nothing twice; a player who left before the hand-over, or whose bank would not take the coins, gets it at the next join.GET /v1/quests/payoutsreads the ledger (an owner's key: a person there is a Discord account). - Valuable rewards go to people, not names (
protect.*, for every server in offline mode): the kinds inprotect.valuable(coins and keys unless the owner says otherwise) are paid once per person - the Discord account a name is linked to, the bucket votes count in, else the name - and only afterprotect.playedof active play (protect.linkedasks for a linked account too). Until a player qualifies the valuable part waits and is handed over the moment they do (looked at when they join and every two minutes); another account of a person already paid, or a server that keeps no links whileprotect.linkedis on, getsprotect.instead. The player is told why, and the quest screen shows it on the card.protect.coins-per-daycaps the coins one person gets a day. - Goals count playing, not farms:
playcounts active time from the progress module (anti-farm.active-play);killleaves out creatures from spawners (anti-farm.kill-origins), creatures carryinganti-farm.kill-tagsand the kills pastanti-farm.kills-per-spotaround one spot (a killing chamber, whatever feeds it); travel goals count only the share of the way covered with input (anti-farm.input), so a minecart loop or a water stream does not finish them; a vein mined in one tick is one block (anti-farm.one-block-a-tick). - A day of grace a week (
streak.grace-per-week, 1): one missed day does not end a streak; it keeps it without adding to it, and the player hears it. - Comfort for a rank, never a bigger reward:
keystone.quests.reroll.<n>adds re-rolls a day andkeystone.quests.slots.<n>quests to the periods inperks.slots-in, up toperks.most. - Chapters that pay (module
milestones):chapters.listnames chapters by the entity tag that says one is done - what a quest mod's reward command gives (FTB Quests' stage reward is that tag) - with a title, an icon and rewards of a quest's kinds, paid once per player, or once per team withchapters.once = team;chapters.all-donepays for the whole book andchapters.announcetells everybody. The milestones module has its ownprotect.*and its own ledger (milestones_paid);GET /v1/milestones/chapters,GET /v1/milestones/payouts, and the eventChapterCompletedfor addons. A player who carried a chapter's tag before the chapter was named is paid at the next look, once. - The quest screen's data (
quests.state, for the client half): a section per period andchapters, each withresetsAt,count,done,bonus,bonusPaidandquests; a quest'sheldsays what its valuable reward waits for or why it went elsewhere (link,playtimewithheldForseconds,person,team,cap,no-links);streakGrace,streakGraceWeekandstreakSavedfor the streak, andpayoutfor the player's standing.QuestSetCompletedis emitted when a whole set is done. - The editor's Quests screen: the pools of each period as rows, what a pool pays one player per day, week or month
(the server's own sum,
POST /v1/quests/preview, from the drafted lines), the streak, a rank's comfort, the protection, and the chapters - all drafts applied from the review bar, checked by the module's own parser. Lists inGET /v1/settingscarry theiritems, so an item with a comma stays one item. - Owner only: every setting that decides what quests and chapters pay or who gets it (
quests.weekly.*,quests.protect.*,quests.perks.*,milestones.chapters.*,milestones.protect.*, andmilestones.commands, which runs as the console) can no longer be written by a group withkeystone.settings.write. - Both modules stay off by default; no default pool pays coins or keys.
K, redone
- K, redone: the cards first. K opens on a card for every part of Keystone this server runs for the player (Bank,
Land, Quests, Market, Travel, People, Votes, Lists), each with a live line, and around them the player (name, rank,
account, vote), where they stand (world, whose land, the effects of places with a switch each) and the server (who is
online, the news, open polls, links). Opening a card keeps one frame: the cards on a rail at the left, the page
beside them, Esc back. Keys: 1 to 9 open a card,
/finds a card or a player, arrows and Enter. - New pages in that frame: Land (where you stand, your plots and the way to the map, every effect of places with
its switch and what is still to unlock), Server & help (who is on, TPS, the restart, the rules, a ticket to the
staff, what is new, links), Bank (the balance and deposit, withdraw, pay - when the server runs the bank), and for
staff Admin (who is on, one player picked, warnings, history, inventory, warn and kick with a reason). Quests
(
/questsopens the same page) has a tab per section the server sends, each with how many are done, the streak, and on every quest its progress, reward, a pin onto the HUD and a re-roll. - Every server sets K up for itself (
k.*inclient.toml, in the editor under Settings):k.cards(which cards and their order),k.own-cards(your own: icon, title, a line with HUD values, and a command, a link or one of Keystone's pages),k.panels,k.links,k.rules,k.title,k.staff-permission. A card of Keystone's shows only when the server runs the part behind it and the player may use it. Staff cards are sent to staff only; nobody else is told they exist. - K costs the server nothing while it is open: its layout is sent once when a player opens it (at most once a second per player), the numbers on it are the HUD values the client already has, and the news and polls are answered from memory.
- The same room on every monitor: K draws in units of its own, as large as the player's GUI scale allows while the screen still holds 640 by 360 of them, so its layout is the same at 720p, 1080p and 1440p and no word is cut.
- Server & help lists the ranks playing gives: each with what it takes and how far you are, and a tag on the
ones you hold (from the progress module's
promotions, numbers grouped the way your language writes them). - Admin: a Chat history button (see Staff below) and the number of tickets waiting on the Tickets button.
/in K starts a new search rather than adding to the last one.- Every window the server opens (quests, market, crates, lists, votes, the changelog, plots, settings) has the four stripes of K's frame under its title, and one opened from a card of K closes back to K.
- Nicks everywhere a name is shown (found in the game test, 16 Nov): K's Online now list, the tab list of a player
with the client half and the head of a chat line show the name somebody goes by (
/nick), as the plain chat and the vanilla tab list already did; clicking still sends/tpato the account./paytakes a nick too, when no account carries that name (one person only, never a guess). - The Quests card counts each period apart:
0 / 3 today · 0 / 3 this week- a weekly quest was counted as one of today's (0 / 6 today).
Staff
- Chat history for staff (module
moderation,chat-history.days, 7): every line a player says in chat is kept for that many days - written off the server thread, older lines deleted every hour - and read with/chatlog <player> [page](permissionkeystone.chatlog), from the new Chat history button in K → Admin, or overGET /v1/moderation/chat(moderation.read). Lines a filter or a mute refused are not kept.0keeps nothing and deletes what was kept.
The ore world
- The ore world has terrain of its own (
template=ore-world): Keystone's generatorkeystone:ore_world- mountains over the land, mostly solid rock under it with large dry caves, no sea, no aquifers, bare stone and deepslate where every ore shows, and Keystone's dense veins of every ore the pack tags. Its biome is tagged as an overworld biome, so the ores mods add to every overworld biome grow in it too. Before, the template was the game's cave dimension, which came out flooded and mostly hollow. - No structures where the line says so:
structures=false(the ore world's default) - no village, stronghold, mineshaft or mod's ruin to claim or loot;/locatefinds none. - A new template waits for the reset: a world that already has land keeps what made it until its next reset, and takes the new generator as it is wiped. Until then it is ruled as the old template (no extra veins, its structures). A world never saved takes the new template at once.
- The platform follows new land: with
seed=randomand no written spawn, the ground is found again after every reset; where it moved, a new platform is built on it (a roofed world's spawn stays and gets its kept box back). Its floor is the middle height of the ground under it.platform-size,platform-blockandplatform-light(lights set into the floor, so no monster spawns on it); the signs come from the language file (worlds.platform.sign.1-4) whenplatform-signsis empty. - The spawn claimed for a team after every reset (
claim-team,claim-radius, FTB Chunks): after the old world's claims are released.claim-teamholds the team's id, never its name (a player can name a party anything): choose it in the editor's Worlds screen (FTB's teams, the server's first) or with/keystone worlds claim-team <world> <team>, which takes the exact name of a single server team and writes its id. Without FTB Chunks the step is skipped with one line in the log; a team that is gone is shown in the editor.
STYGION Keystone Voice 1.1.0 (its own jar, released with Keystone 0.5.0)
- A much better voice, and one that reads every line in its own language. Chat read aloud now speaks 31 languages with one natural voice at 44.1 kHz - English, Czech, Slovak, German, Polish, Spanish, French, Italian, Portuguese, Dutch, Russian, Ukrainian, Turkish and 18 more - female or male. Before, it had English and Czech only and sounded like a machine (Piper). A line is read in the language the server names for it (the reader's own when it names none, as before); a line in a language the voice was not taught is read as written, the voice working the language out itself, instead of being forced into English.
- What is downloaded changed: when you press Download in K → Settings → Language & voice, about 155 MB once - the
voice model Supertonic 3 (145 MB, from Hugging Face, pinned to one commit) and the sherpa-onnx 2.0.1 runtime (8 to
13 MB, from its GitHub release), every file checked against a SHA-256 in the mod. Still nothing before you ask,
still all offline afterwards, still in
config/keystone/tts/(delete the folder to remove it). The Piper files of 1.0 are deleted once the new voice is there.voice/README.mdlists every file, its source and its licence. - macOS and Windows on ARM too: the voice runs in a small Java process of its own beside the game, started with the game's own Java, so it works wherever the game does (Windows, Linux, macOS; x64 and ARM64).
- Settings list the languages the voice reads (needs the Keystone that ships with this voice; with Keystone 0.4.3 the voice works the same, the list is just not shown).
- Try the voice speaks your game's language when it has a line for it (13 languages), else English - before, a game in German read the English line with German rules.
This mod has no additional files