3. 玩家角色¶

在上一課關於規則和骰子滾動中，我們對「玩家角色」實體做了一些假設：

它應該將自身的能力儲存為 character.strength、character.constitution 等。
它應該有一個 .heal(amount) 方法。

所以我們有一些關於它的外觀的指導方針！字元是一個資料庫實體，其值應該能夠隨著時間的推移而變更。以 Evennia 為基礎是有意義的 DefaultCharacter Typeclass。 Character 類別就像桌面上的“字元表” RPG，它將儲存與PC相關的所有內容。

3.1. 繼承結構¶

玩家角色（PC）並不是我們世界上唯一「有生命」的東西。我們還有_NPC_ （如店家和其他友軍）以及可以攻擊我們的_怪物_（小怪）。

在程式碼中，我們可以透過幾種方法來建構它。如果 NPCs/monsters 只是 PC 的特殊情況，我們可以使用這樣的類別繼承：

from evennia import DefaultCharacter

class EvAdventureCharacter(DefaultCharacter):
    # stuff

class EvAdventureNPC(EvAdventureCharacter):
    # more stuff

class EvAdventureMob(EvAdventureNPC):
    # more stuff

我們放在 Character 類別上的所有程式碼現在都將自動繼承到 NPC 和 Mob 。

然而，在_Knave_中，NPCs，尤其是怪物_不_使用與PC相同的規則——它們被簡化為使用Hit-Die (HD)概念。因此，雖然仍然像字元一樣，NPCs 應該與 PC 分開，如下所示：

from evennia import DefaultCharacter

class EvAdventureCharacter(DefaultCharacter):
    # stuff

class EvAdventureNPC(DefaultCharacter):
    # separate stuff

class EvAdventureMob(EvadventureNPC):
    # more separate stuff

儘管如此，有些事情應該是所有「生物」所共有的：

所有人都會受到傷害。
所有人都會死。
一切都可以治癒
所有人都可以持有和丟失硬幣
所有人都可以掠奪倒下的敵人。
被擊敗後所有人都可能被掠奪。

我們不想為每個類別單獨編碼，但我們不再有一個公共的父類別來放置它。因此，我們將使用 mixin 類別的概念：

from evennia import DefaultCharacter

class LivingMixin:
    # stuff common for all living things

class EvAdventureCharacter(LivingMixin, DefaultCharacter):
    # stuff

class EvAdventureNPC(LivingMixin, DefaultCharacter):
    # stuff

class EvAdventureMob(LivingMixin, EvadventureNPC):
    # more stuff

上面的 LivingMixin 類別不能單獨工作 - 它只是用一些所有生物都應該能夠執行的額外功能來「修補」其他類別。這是_多重繼承_的一個例子。繼承的順序在這裡很重要 - LivingMixin 必須在 DefaultCharacter （或 EvAdventureNPC 等）之前，以便在呼叫時首先找到它的方法。多重繼承是物件導向程式設計中的強大工具，瞭解它很有用。但要小心過度使用它。如果你有太多的 mixin，那就很難理解哪個方法來自哪裡。

3.2. 生活混音類¶

建立一個新模組mygame/evadventure/characters.py

讓我們獲得一些所有生物都應該在我們的遊戲中使用的有用的通用方法。

# in mygame/evadventure/characters.py

from .rules import dice

class LivingMixin:

    # makes it easy for mobs to know to attack PCs
    is_pc = False

	@property
    def hurt_level(self):
        """
        String describing how hurt this character is.
        """
        percent = max(0, min(100, 100 * (self.hp / self.hp_max)))
        if 95 < percent <= 100:
            return "|gPerfect|n"
        elif 80 < percent <= 95:
            return "|gScraped|n"
        elif 60 < percent <= 80:
            return "|GBruised|n"
        elif 45 < percent <= 60:
            return "|yHurt|n"
        elif 30 < percent <= 45:
            return "|yWounded|n"
        elif 15 < percent <= 30:
            return "|rBadly wounded|n"
        elif 1 < percent <= 15:
            return "|rBarely hanging on|n"
        elif percent == 0:
            return "|RCollapsed!|n"

    def heal(self, hp):
        """
        Heal hp amount of health, not allowing to exceed our max hp

        """
        damage = self.hp_max - self.hp
        healed = min(damage, hp)
        self.hp += healed

        self.msg(f"You heal for {healed} HP.")

    def at_pay(self, amount):
        """When paying coins, make sure to never detract more than we have"""
        amount = min(amount, self.coins)
        self.coins -= amount
        return amount

    def at_attacked(self, attacker, **kwargs):
		"""Called when being attacked and combat starts."""
		pass

    def at_damage(self, damage, attacker=None):
        """Called when attacked and taking damage."""
        self.hp -= damage

    def at_defeat(self):
        """Called when defeated. By default this means death."""
        self.at_death()

    def at_death(self):
        """Called when this thing dies."""
        # this will mean different things for different living things
        pass

    def at_do_loot(self, looted):
        """Called when looting another entity"""
        looted.at_looted(self)

    def at_looted(self, looter):
        """Called when looted by another entity"""

        # default to stealing some coins
        max_steal = dice.roll("1d10")
        stolen = self.at_pay(max_steal)
        looter.coins += stolen

其中大部分是空的，因為它們對於角色和 npc 的行為有所不同。但是將它們放在 mixin 中意味著我們可以期望這些方法可用於所有生物。

一旦我們建立了更多的遊戲，我們將需要記住實際呼叫這些鉤子方法，以便它們可以發揮作用。例如，一旦我們實施戰鬥，我們必須記住呼叫at_attacked以及其他涉及傷害、失敗或死亡的方法。

3.3. 字元類¶

我們現在將根據 Knave 的需要開始製作基本的角色類別。

# in mygame/evadventure/characters.py

from evennia import DefaultCharacter, AttributeProperty
from .rules import dice

class LivingMixin:
    # ...


class EvAdventureCharacter(LivingMixin, DefaultCharacter):
    """
    A character to use for EvAdventure.
    """
    is_pc = True

    strength = AttributeProperty(1)
    dexterity = AttributeProperty(1)
    constitution = AttributeProperty(1)
    intelligence = AttributeProperty(1)
    wisdom = AttributeProperty(1)
    charisma = AttributeProperty(1)

    hp = AttributeProperty(8)
    hp_max = AttributeProperty(8)

    level = AttributeProperty(1)
    xp = AttributeProperty(0)
    coins = AttributeProperty(0)

    def at_defeat(self):
        """Characters roll on the death table"""
        if self.location.allow_death:
            # this allow rooms to have non-lethal battles
            dice.roll_death(self)
        else:
            self.location.msg_contents(
                "$You() $conj(collapse) in a heap, alive but beaten.",
                from_obj=self)
            self.heal(self.hp_max)

    def at_death(self):
        """We rolled 'dead' on the death table."""
        self.location.msg_contents(
            "$You() collapse in a heap, embraced by death.",
            from_obj=self)
        # TODO - go back into chargen to make a new character!

我們對這裡的房間做出假設 - 他們擁有 .allow_death 的財產。我們需要做一個註釋，以便稍後將這樣的屬性新增到房間中！

在我們的 Character 類別中，我們實作了想要從 Knave 規則集中模擬的所有屬性。 AttributeProperty 是一種以類似欄位的方式新增 Attribute 的方法；每個角色都可以透過多種方式存取這些內容：

作為character.strength
作為character.db.strength
作為character.attributes.get("strength")

請參閱屬性以瞭解屬性的工作原理。

與基地 Knave 不同，我們將 coins 儲存為單獨的 Attribute，而不是作為庫存中的物品，這使得以後更容易處理以物易物和交易。

我們實現了at_defeat和at_death的玩家角色版本。我們也使用 LivingMixin 類別中的 .heal()。

3.3.1. 函式解析器內聯¶

上面 at_defeat 方法中的這段程式碼值得更多額外的解釋：

self.location.msg_contents(
    "$You() $conj(collapse) in a heap, alive but beaten.",
    from_obj=self)

請記住，self 是此處的角色例項。所以 self.location.msg_contents 的意思是「向我目前位置內的所有內容傳送訊息」。換句話說，向與該角色處於同一位置的每個人傳送訊息。

$You() $conj(collapse) 是 FuncParser 內聯。這些是在字串中執行的函式。對於不同的受眾來說，產生的字串可能看起來不同。 $You() 行內函數將使用 from_obj 來確定「您」是誰，並顯示您的名字或「您」。 $conj()（動詞變形器）將調整（英文）動詞以符合。

您將看到："You collapse in a heap, alive but beaten."
房間裡的其他人將會看到："Thomas collapses in a heap, alive but beaten."

請注意 $conj() 如何選擇 collapse/collapses 以使句子在語法上正確。

3.3.2. 回溯¶

我們第一次使用rules.dice滾輪在死亡桌上滾動！您可能還記得，在上一課中，我們不知道在這張桌子上滾動“死亡”時該怎麼做。現在我們知道了 - 我們應該對角色呼叫 at_death。因此，讓我們在之前 TODOs 的位置新增：

# mygame/evadventure/rules.py

class EvAdventureRollEngine:

    # ...

    def roll_death(self, character):
        ability_name = self.roll_random_table("1d8", death_table)

        if ability_name == "dead":
            # kill the character!
            character.at_death()  # <------ TODO no more
        else:
            # ...

            if current_ability < -10:
                # kill the character!
                character.at_death()  # <------- TODO no more
            else:
                # ...

3.4. 將角色與Evennia連線¶

您可以使用以下方法輕鬆地讓自己成為遊戲中的EvAdventureCharacter type指令：

type self = evadventure.characters.EvAdventureCharacter

現在您可以執行 examine self 來檢查您的型別已更新。

如果您希望_所有_新角色都屬於這種型別，您需要告知Evennia。 Evennia 使用全域設定 BASE_CHARACTER_TYPECLASS 來瞭解建立角色時（例如登入時）要使用哪一個 typeclass。預設為 typeclasses.characters.Character（即 mygame/typeclasses/characters.py 中的 Character 類）。

因此，有兩種方法可以將新的 Character 類別編織到 Evennia 中：

更改 mygame/server/conf/settings.py 並新增 BASE_CHARACTER_TYPECLASS = "evadventure.characters.EvAdventureCharacter"。
或者，將 typeclasses.characters.Character 更改為從 EvAdventureCharacter 繼承。

您必須始終重新載入伺服器才能使此類變更生效。

Important

在本教學中，我們將在資料夾 mygame/evadventure/ 中進行所有變更。這意味著我們可以隔離我們的程式碼，但這意味著我們需要執行一些額外的步驟將角色（和其他物件）繫結到 Evennia 中。對於自己的遊戲，直接開始編輯mygame/typeclasses/characters.py就可以了相反。

3.5. 單元測試¶

建立一個新模組mygame/evadventure/tests/test_characters.py

為了測試，我們只需要建立一個新的 EvAdventure 字元並檢查呼叫它的方法不會出錯。

# mygame/evadventure/tests/test_characters.py

from evennia.utils import create
from evennia.utils.test_resources import BaseEvenniaTest

from ..characters import EvAdventureCharacter

class TestCharacters(BaseEvenniaTest):
    def setUp(self):
        super().setUp()
        self.character = create.create_object(EvAdventureCharacter, key="testchar")

    def test_heal(self):
        self.character.hp = 0
        self.character.hp_max = 8

        self.character.heal(1)
        self.assertEqual(self.character.hp, 1)
        # make sure we can't heal more than max
        self.character.heal(100)
        self.assertEqual(self.character.hp, 8)

    def test_at_pay(self):
        self.character.coins = 100

        result = self.character.at_pay(60)
        self.assertEqual(result, 60)
        self.assertEqual(self.character.coins, 40)

        # can't get more coins than we have
        result = self.character.at_pay(100)
        self.assertEqual(result, 40)
        self.assertEqual(self.character.coins, 0)

    # tests for other methods ...

如果您遵循了前面的課程，這些測驗應該看起來很熟悉。考慮新增其他方法的測試作為練習。詳細內容請參考之前的課程。

為了執行您所做的測試：

 evennia test --settings settings.py .evadventure.tests.test_characters

3.6. 關於比賽和班級¶

Knave 沒有任何 D&D 風格的_職業_（如小偷、戰士等）。它也不關心_種族_（如矮人、精靈等）。這使得教學變得更短，但您可能會問自己如何新增這些功能。

在我們為 Knave 勾勒出的框架中，這很簡單 - 你可以將你的種族/職業新增為你的角色的 Attribute：

# mygame/evadventure/characters.py

from evennia import DefaultCharacter, AttributeProperty
# ...

class EvAdventureCharacter(LivingMixin, DefaultCharacter):

    # ...

    charclass = AttributeProperty("Fighter")
    charrace = AttributeProperty("Human")

我們在這裡使用charclass而不是class，因為class是Python的保留關鍵字。將 race 命名為 charrace 因此在風格上配對。

然後我們需要擴充套件我們的規則模組（稍後字元產生檢查並包含這些類別的含義。

3.7. 概括¶

EvAdventureCharacter 類別就位後，我們可以更瞭解我們的電腦在 Knave 下的樣子。

目前，我們只有一些零碎的東西，還沒有在遊戲中測試這段程式碼。但如果你願意的話，你現在就可以把自己變成EvAdventureCharacter。登入您的遊戲並執行指令

type self = evadventure.characters.EvAdventureCharacter

如果一切順利，ex self 現在會將您的 typeclass 顯示為 EvAdventureCharacter。看看你的實力

py self.strength = 3

Important

執行 ex self 時，您將不會看到列出的所有能力。這是因為用 AttributeProperty 新增的屬性在至少被訪問一次之前才可用。因此，一旦您設定（或檢視）上面的 .strength，從那時起 strength 將顯示在 examine 中。

3. 玩家角色¶

3.1. 繼承結構¶

3.2. 生活混音類¶

3.3. 字元類¶

3.3.1. 函式解析器內聯¶

3.3.2. 回溯¶

3.4. 將角色與Evennia連線¶

3.5. 單元測試¶

3.6. 關於比賽和班級¶

3.7. 概括¶

目錄

Previous topic

Next topic

連結

文件版本