Features

Calendar

The Calendar app: own events with reminders, the town's events, payment days from your own scripts, and Config.Takvim.

Calendar (takvim) keeps the character's own events and shows the town's events: rodeo, fair, train times, auctions. Dates are the server's real calendar; only the printed year is shifted. Settings are in apps/takvim/config.lua (Config.Takvim) and apps/takvim/config_server.lua.

#What the player can do

  • See a month of day tiles and the events of the picked day.
  • Add an event in four steps (personal, work or payment), with a place, a note and a reminder. Edit and delete their events.
  • Read the agenda of what is coming, town events included for AgendaDays days.
  • Set a reminder on a town event, and mark its place on the map.
  • Get the reminder as a pocketbook notification, with the book open or closed. A reminder that came due while the character was away is shown when they come back, if the event is still ahead.
  • See their payment days (bills, taxes, rent) when your server fills the PaymentDays hook. These are read only.

No signal, money or items are needed.

#Settings

Key Default What it does
Enabled true Turns the app on
YearOffset -127 Year shown = real year + this (2026 becomes 1899). 0: real year
MaxEvents 60 Events and town reminders a character can keep
KeepDays 60 Past events are deleted after this many days
AgendaDays 45 How far ahead the agenda shows town events
ReminderMinutes { 0, 10, 60, 1440 } Reminder choices in minutes. 0: none
Waypoint { RouteColor = 'COLOR_YELLOW', ArrivalDistance = 15.0 } The map route of Mark the location. It clears on arrival
TownEvents four events See below

#Town events

Players cannot change town events; they set a reminder and mark the place.

lua{ id = 'rodeo', title = 'Valentine Rodeosu', place = 'Valentine meydani', icon = 'horse-human',
  note = 'Yabani at binme ve kement yarisi.',
  every = 'week', days = { 6 }, time = '21:00', coords = vector3(-281.0, 793.0, 119.0) },
Field What it is
id Short unique name (lower case letters, digits, _). Changing it drops reminders already set
every 'day', or 'week' with days (1 = Monday ... 7 = Sunday)
dates One-off days as { 'YYYY-MM-DD', ... } on the real calendar. Do not set every with it
time 'HH:MM' on the server clock
coords vector3. Without it Mark the location is off
icon A file name in preview/assets/mdi/ without .svg
title, place, note Texts shown

The shipped events are the Saint Denis train (Tuesday and Friday 09:40), the animal auction (Thursday 13:00), the Valentine rodeo (Saturday 21:00) and the Rhodes fair (Sunday 20:00). Their coordinates are approximate; correct them for your map.

A one-off event:

lua{ id = 'yilbasi', title = 'Yilbasi balosu', place = 'Saint Denis tiyatrosu', icon = 'drama-masks',
  dates = { '2026-12-31' }, time = '21:00', coords = vector3(2540.0, -1272.0, 49.0) },

#Payment days

PaymentDays in apps/takvim/config_server.lua is a function you write. It returns at most 20 rows that the calendar shows read only. The calendar never pays anything.

luaPaymentDays = function(src, char)
    -- char = { id, name, job, grade, framework }
    return {
        { title = 'Ciftlik vergisi', place = 'Tapu dairesi', note = '24 dolar', at = os.time() + 3 * 86400 },
    }
end,

at is a unix time. If the function errors, the list counts as empty. The default is nil (no payment days).