更改比賽日曆和時間速度

許多遊戲使用單獨的時間系統，我們稱之為「遊戲時間」。這與我們通常認為的“實時”並行執行。 遊戲時間可能會以不同的速度執行，使用不同的 其時間單位的名稱，甚至可能使用完全自訂的日曆。您根本不需要依賴遊戲時間系統。但如果您這樣做，Evennia 提供了處理這些不同情況的基本工具。本教學將引導您瞭解這些功能。

標準日曆的比賽時間

許多遊戲讓他們的遊戲時間比即時執行得更快或更慢，但仍然使用我們的正常時間 現實世界的日曆。這對於以當今為背景的遊戲以及過去的遊戲來說都很常見。 歷史或未來的背景。使用標準日曆有一些優點：

• 處理重複操作要容易得多，因為從即時體驗轉換為即時體驗 遊戲中的感知很容易。

• 現實世界日曆的複雜性，包括閏年和不同長度的月份等 由系統自動處理。

Evennia 的遊戲時間功能採用標準日曆（有關自訂日曆，請參閱下面的相關部分）。

為標準日曆設定比賽時間

一切都是透過設定完成的。 如果您想玩遊戲，請使用以下設定 標準日曆：

# in a file settings.py in mygame/server/conf
# The time factor dictates if the game world runs faster (timefactor>1)
# or slower (timefactor<1) than the real world.
TIME_FACTOR = 2.0

# The starting point of your game time (the epoch), in seconds.
# In Python a value of 0 means Jan 1 1970 (use negatives for earlier
# start date). This will affect the returns from the utils.gametime
# module.
TIME_GAME_EPOCH = None

預設情況下，遊戲時間執行速度是即時時間的兩倍。 您可以將時間係數設為 1（遊戲時間將以與即時完全相同的速度執行）或更低（遊戲時間將比即時慢）。 大多數遊戲選擇讓遊戲時間旋轉得更快（你會發現一些遊戲的時間係數為 60，這意味著遊戲時間比即時時間快 60 倍，即時時間一分鐘將是遊戲時間一小時）。

時代是一個稍微複雜的設定。 它應該包含一些秒數 指示您的遊戲開始的時間。 如前所述，紀元 0 表示 1970 年 1 月 1 日。如果 你想設定未來的時間，你只需要在幾秒鐘內找到起點。 那裡 在 Python 中有多種方法可以實現此目的，此方法將向您展示如何在本機時間執行此操作：

# We're looking for the number of seconds representing
# January 1st, 2020
from datetime import datetime
import time
start = datetime(2020, 1, 1)
time.mktime(start.timetuple())

這應該會返回一個巨大的數字 - 自 1970 年 1 月 1 日以來的秒數。將其直接複製到您的設定中（編輯 server/conf/settings.py）：

# in a file settings.py in mygame/server/conf
TIME_GAME_EPOCH = 1577865600

使用@reload重新載入遊戲，然後使用@time指令。 你應該會看到類似的東西 這個：

+----------------------------+-------------------------------------+
| Server time                |                                     |
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+
| Current uptime             | 20 seconds                          |
| Total runtime              | 1 day, 1 hour, 55 minutes           |
| First start                | 2017-02-12 15:47:50.565000          |
| Current time               | 2017-02-13 17:43:10.760000          |
+----------------------------+-------------------------------------+
| In-Game time               | Real time x 2                       |
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+
| Epoch (from settings)      | 2020-01-01 00:00:00                 |
| Total time passed:         | 1 day, 17 hours, 34 minutes         |
| Current time               | 2020-01-02 17:34:55.430000          |
+----------------------------+-------------------------------------+

這裡最相關的行是遊戲時間紀元。 您會看到它顯示於 2020-01-01。 來自 至此，比賽時間不斷增加。 如果你繼續輸入@time，你會看到遊戲 時間更新正確…並且（預設）速度是即時的兩倍。

與時間相關的事件

gametime 實用程式還有一種方法來安排與遊戲相關的事件，考慮到您的遊戲時間，並假設標準日曆（請參閱下面的自訂日曆的相同功能）。 例如，它可用於在每天（遊戲內）的 6:00 AM 傳送特定訊息，顯示太陽如何升起。

這裡應該使用函式schedule()。 它將建立一個具有一些附加功能的 script，以確保當遊戲時間與給定引數匹配時始終執行 script。

schedule 函式採用下列引數：

• 回撥，時間到時呼叫的函式。

• 關鍵字repeat（預設為False）指示是否應重複呼叫此函式。

• 其他關鍵字引數 sec、min、hour、day、month 和 year 用於描述計畫時間。 如果未給予該引數，則假定該特定單位的目前時間值。

這是讓太陽每天升起的一個簡短範例：

# in a file ingame_time.py in mygame/world/

from evennia.utils import gametime
from typeclasses.rooms import Room

def at_sunrise():
    """When the sun rises, display a message in every room."""
    # Browse all rooms
    for room in Room.objects.all():
        room.msg_contents("The sun rises from the eastern horizon.")

def start_sunrise_event():
    """Schedule an sunrise event to happen every day at 6 AM."""
    script = gametime.schedule(at_sunrise, repeat=True, hour=6, min=0, sec=0)
    script.key = "at sunrise"

如果你想測試這個功能，你可以輕鬆地執行以下操作：

@py from world import ingame_time; ingame_time.start_sunrise_event()

script 將被靜默建立。 at_sunrise 函式現在將在遊戲中的每個日呼叫 6AM。可以使用@scripts指令來檢視。您可以使用 @scripts/stop 來停止它。如果 我們沒有設定repeat，太陽只會升起一次，然後就不會再升起。

我們在這裡使用了 @py 指令：沒有什麼可以阻止您將系統新增到遊戲程式碼中。但請記住，不要在啟動時新增每個事件，否則在太陽升起時會安排許多重疊的事件。

當使用設定為 True 的 repeat 時，schedule 函式適用於較高的、未指定的單位。 在我們的範例中，我們指定了小時、分鐘和秒。 我們沒有指定的較高單位是 day: schedule 假設我們的意思是「每天在指定時間執行回呼」。 因此，你 可以有一個每小時 HH:30 執行的事件，或每月第 3 天執行的事件。

請注意每月或每年重複 scripts：由於 現實生活中的日曆在安排月末或年末的活動時需要小心。 例如，如果您將 script 設定為每月 31 號執行，它將在一月執行，但找不到 二月、四月等的這一天。同樣，閏年可能會改變一年中的天數。

帶有自訂日曆的遊戲時間

如果您想將遊戲置於虛構的宇宙中，有時需要使用自訂日曆來處理遊戲時間。 例如，您可能想要建立託爾金所描述的夏爾曆，有 12 個月，每個月 30 天。這樣一來，一年只有 360 天（大概哈比人並不真正喜歡遵循天文日曆的麻煩）。 另一個例子是在不同的太陽系中創造一顆行星，例如，白天長 29 小時，月份只有 18 天。

Evennia 透過選購的 contrib 模組（稱為 custom_gametime）處理自訂日曆。 與上述正常的 gametime 模組相反，它預設不處於活動狀態。

設定自訂日曆

在託爾金書中哈比人使用的夏爾日曆的第一個例子中，我們實際上並不需要周的概念……但我們需要有 30 天而不是 28 天的月份的概念。

自訂日曆是透過將 TIME_UNITS 設定新增至您的設定檔來定義的。它是一個字典，其中包含單位名稱作為鍵，以及該單位中的秒數（我們的最小單位）作為值。它的鍵必須從以下選項中選擇：“秒”、“分鐘”、“小時”、“日”、“週”、“月”和“年”，但不必全部包含。 以下是 Shire 日曆的設定：

# in a file settings.py in mygame/server/conf
TIME_UNITS = {"sec": 1,
              "min": 60,
              "hour": 60 * 60,
              "day": 60 * 60 * 24,
              "month": 60 * 60 * 24 * 30,
              "year": 60 * 60 * 24 * 30 * 12 }

我們將我們想要的每個單位作為金鑰。 值表示該單位的秒數。 小時設定為60 * 60（即每小時3600秒）。 請注意，我們在此設定中沒有指定週單位：相反，我們直接從天跳到月。

為了使此設定正常工作，請記住所有單位都必須是先前單位的倍數。 例如，如果您建立“日”，則它需要是多個小時。

因此，對於我們的範例，我們的設定可能如下所示：

# in a file settings.py in mygame/server/conf
# Time factor
TIME_FACTOR = 4

# Game time epoch
TIME_GAME_EPOCH = 0

# Units
TIME_UNITS = {
        "sec": 1,
        "min": 60,
        "hour": 60 * 60,
        "day": 60 * 60 * 24,
        "month": 60 * 60 * 24 * 30,
        "year": 60 * 60 * 24 * 30 * 12,
}

請注意，我們已將時間紀元設定為 0。使用自訂日曆，我們將自己設計出漂亮的時間顯示。在我們的例子中，遊戲時間從第 0 年、第 1 月、第 1 天和午夜開始。

年、時、分、秒從0開始，月、週、日從1開始，這使得它們 行為與標準時間一致。

請注意，雖然我們在設定中使用「月」、「週」等，但您的遊戲可能不會在遊戲中使用這些術語，而是將它們稱為「週期」、「月亮」、「沙落」等。這只是您的問題 以不同的方式顯示它們。請參閱下一節。

顯示當前遊戲時間的指令

如前所述，@time 指令旨在與標準日曆一起使用，而不是與自訂日曆一起使用。 不過我們可以輕鬆建立一個新指令。 我們稱之為time，就像通常的情況一樣 其他MU*。 這是我們如何編寫它的範例（例如，您可以建立一個檔案 gametime.py 在您的 commands 目錄中並將此程式碼貼到其中）：

# in a file mygame/commands/gametime.py

from evennia.contrib.base_systems import custom_gametime

from commands.command import Command

class CmdTime(Command):

    """
    Display the time.

    Syntax:
        time

    """

    key = "time"
    locks = "cmd:all()"

    def func(self):
        """Execute the time command."""
        # Get the absolute game time
        year, month, day, hour, mins, secs = custom_gametime.custom_gametime(absolute=True)
        time_string = f"We are in year {year}, day {day}, month {month}."
        time_string += f"\nIt's {hour:02}:{mins:02}:{secs:02}."
        self.msg(time_string)

不要忘記將其新增到您的 CharacterCmdSet 中以檢視此指令：

# in mygame/commands/default_cmdset.py

from commands.gametime import CmdTime   # <-- Add

# ...

class CharacterCmdSet(default_cmds.CharacterCmdSet):
    """
    The `CharacterCmdSet` contains general in-game commands like `look`,
    `get`, etc available on in-game Character objects. It is merged with
    the `AccountCmdSet` when an Account puppets a Character.
    """
    key = "DefaultCharacter"

    def at_cmdset_creation(self):
        """
        Populates the cmdset
        """
        super().at_cmdset_creation()
        # ...
        self.add(CmdTime())   # <- Add

使用 @reload 指令重新載入遊戲。 您現在應該看到 time 指令。 如果您輸入它，您可能會看到類似以下內容：

We are in year 0, day 0, month 0.
It's 00:52:17.

如果您願意，您可以更漂亮地顯示幾個月甚至幾天的名稱。 如果“月份”在您的遊戲中被稱為“月亮”，那麼您就需要在此處新增它。

自訂遊戲時間中與時間相關的事件

custom_gametime 模組還可以考慮您的遊戲時間（以及您的自訂日曆）來安排與遊戲相關的事件。 它可用於每天 6:00 AM 傳送特定訊息，例如顯示太陽升起。 custom_gametime.schedule 函式的工作方式與上述預設函式的工作方式相同。