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
AgendaDaysdays. - 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
PaymentDayshook. 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).