Skip to content

Tilttek, open gamification tools

PHP libraries and Symfony bundles, under the MIT licence, that make a site more playful: dice, generators, points, badges, progression, quests, collections, exchanges and leaderboards.

Isometric gamification illustration: a trophy on a podium, a leaderboard, medals, a die, a game controller and a “1UP”.

The tools

The same mechanics come back on every site that wants to reward its members or run a game. Tilttek writes them once, tested and documented.

The tools are open, the data belongs to the sites

Every package is under the MIT licence and installs in the site itself. Tilttek hosts nothing and keeps nothing: points, badges and rankings stay in the site's own database.

A member is an opaque reference that the site supplies: Tilttek reads no name, no email and no account.

The catalogue today

Each package page is generated from the package's own README and documentation, in English and in French.

The families

Latest news

— The November 20 evening release

Eleven more Tilttek packages are published this evening, which makes 54, and nineteen published packages move to a new version. The new ones bring escape rooms built from chained puzzles, a dice tower the whole table shares, a jail for unlucky dice and the odds of a dice expression, verifiable raffles, and in a Symfony site reward shops, advent calendars, loot boxes sold in an order, luck tokens and table safety tools. The new versions harden dice, generators, puzzles, ratings and luck tokens against input they should refuse, and no longer accept the 0.1 versions of tilttek/dice, tilttek/points and tilttek/sets. Like the others, they are free, at 0.1.0-alpha, and documented in English and in French. See the catalogue.

Gamification core

  • tilttek/exchange-bundle — Exchange in Symfony: members redeem rewards, give points and trade items, kept in the database with forms, safeguards and expiry.
  • tilttek/advent-calendar-bundle — Advent calendars in Symfony: in configuration or the database, each box opened once, a screen that works without JavaScript and a celebration.
  • tilttek/raffle — Raffles where everyone holds one chance and nobody buys more: the entrant list is fixed and hashed first, and anyone can check the draw was fair.

Dice and randomness

  • tilttek/dice-probability-bundle — The odds of a dice expression in Twig, as an accessible table and chart, updated live as it is typed.
  • tilttek/dice-jail — Send unlucky dice to jail, then check them with a fair statistical test, explained plainly, that never calls a die loaded without the evidence.
  • tilttek/dice-tower — A table's shared dice tower: every roll seen by everyone at the table, live and in order, with missed rolls read back from the log.
  • tilttek/loot-tables-bundle — Loot boxes sold in an order, committed when placed and drawn once paid, with physical dice at a register and proof kept.

At the table

  • tilttek/table-safety-bundle — Table safety tools in Symfony: lines and veils, signals raised by players, a game master's screen with live alerts, anonymous by default.
  • tilttek/luck-tokens-bundle — Inspiration and fate tokens per table in Symfony, every move stored in the database, with events, access rules and member erasure.

Games and contests

  • tilttek/escape-room — Escape rooms built from chained puzzles: a countdown, hints that cost time, a host console, bookable sessions and a leaderboard by consent.
  • tilttek/escape-room-bundle — Escape rooms in Symfony: rooms, bookings, a host console, live hint screens, countdowns that end on time and a leaderboard by consent.

New versions

  • tilttek/dice 0.3.1-alpha — The canonical form writes successes after a bare explosion between brackets, so it reads back as the same roll.
  • tilttek/dice-bundle 0.2.2-alpha — Requires tilttek/dice 0.2 or 0.3: 0.1 is no longer accepted.
  • tilttek/dice-probability 0.1.4-alpha — The search of the groups that reach a sum and the binomial coefficients count in the budget of an estimate.
  • tilttek/generator 0.2.2-alpha — A seed is at most 256 characters long, and weights that add up past the largest integer are refused.
  • tilttek/generator-bundle 0.2.2-alpha — Requires tilttek/dice 0.2 or 0.3: 0.1 is no longer accepted.
  • tilttek/secret-rolls 0.2.2-alpha — Requires tilttek/dice 0.2 or 0.3: 0.1 is no longer accepted.
  • tilttek/accessible-dice 0.1.3-alpha — Two forms on a page no longer share their identifiers, so each label points to its own field.
  • tilttek/weather 0.1.3-alpha — A temperature is read only from a whole number: true or a decimal is refused.
  • tilttek/dice-skins 0.1.1-alpha — A skin of the wrong type is refused with InvalidSkin rather than a TypeError.
  • tilttek/heraldry 0.1.1-alpha — The prefix of the ids an image derives takes its title and language too, so two images on a page never clash.
  • tilttek/leaderboards 0.2.1-alpha — Deleting a score on Valkey always takes it out of the member's index.
  • tilttek/luck-tokens 0.1.1-alpha — The entry limit of a ledger is checked as each entry is written.
  • tilttek/puzzle-builder 0.1.1-alpha — Saved progress that could not have been played is refused when it is read.
  • tilttek/rating 0.1.1-alpha — A day or a time that does not exist is refused in a game result.
  • tilttek/seasonal-events 0.1.1-alpha — A multiplier applied to a large amount no longer overflows.
  • tilttek/bounties 0.1.1-alpha — Requires tilttek/points 0.2: 0.1 is no longer accepted.
  • tilttek/exchange 0.2.1-alpha — Requires tilttek/points 0.2: 0.1 is no longer accepted.
  • tilttek/friend-challenges 0.1.1-alpha — Requires tilttek/points 0.2: 0.1 is no longer accepted.
  • tilttek/stickers 0.1.3-alpha — Requires tilttek/sets 0.2 or 0.3: 0.1 is no longer accepted.

— The November 17 evening release

Twelve published Tilttek packages move to a new version tonight. Verifiable rolls now hold only for the roll announced, and a team quest is accepted only for a member of the team; the packages that use the dice accept the new version. See the catalogue.

New versions

— The November 15 evening release

Two more Tilttek packages are published this evening, which makes 43, and three published packages move to a new version. They bring luck tokens a table hands out and spends, and leaderboards in a Symfony site. Like the others, they are free, at 0.1.0-alpha, and documented in English and in French. See the catalogue.

Gamification core

  • tilttek/leaderboards-bundle — Leaderboards in Symfony: periods, weekly leagues, scores kept up to date from members' activity, and export and erasure of their data.

At the table

  • tilttek/luck-tokens — Luck, inspiration or fate tokens a table hands out and spends, every move kept in a ledger.

New versions

  • tilttek/badges-bundle 0.3.0-alpha — The badge issued as an Open Badges credential is the award with the highest number, secured by phil/open-badges-bundle.
  • tilttek/table-safety 0.3.0-alpha — The session zero pact and the table agreement also show answers only in groups of at least three people.
  • tilttek/sets 0.3.0-alpha — A Symfony command tells pending completions again, with a delay that grows after each failure.

All the news