隨機名稱產生器

貢獻者InspectorCaracal (2022)

用於產生隨機名稱的模組，包括現實世界和幻想世界。現實世界 名稱可以產生為名字、姓氏或 全名（名字、可選的中間名和姓氏）。姓名資料來自姓名背後 並在 CC BY-SA 4.0 許可證 下使用。

幻想名稱是根據基本語音規則使用 CVC 音節語法產生的。

現實世界和幻想名稱的生成都可以擴充套件以包括額外的 透過您的遊戲的 settings.py 獲取資訊

安裝

這是一個獨立的實用程式。只需匯入此模組（from evennia.contrib.utils import name_generator）並在任何您喜歡的地方使用它的功能即可。

用法

使用以下指令將模組匯入到需要的地方：

from evennia.contrib.utils.name_generator import namegen

預設情況下，所有函式都將傳回具有一個生成名稱的字串。 如果指定多個，或傳遞 return_list=True 作為關鍵字引數，則傳回值將是字串清單。

此模組對於命名新建立的 NPCs 特別有用，如下所示：

npc_name = namegen.full_name()
npc_obj = create_object(key=npc_name, typeclass="typeclasses.characters.NPC")

可用設定

這些設定都可以在遊戲的 server/conf/settings.py 檔案中定義。

• NAMEGEN_FIRST_NAMES 新增新的名字清單。

• NAMEGEN_LAST_NAMES 新增新的姓氏清單。

• NAMEGEN_REPLACE_LISTS - 如果您只想使用設定中定義的名稱，請設定為 True。

• NAMEGEN_FANTASY_RULES 允許您新增新的語音規則來產生完全虛構的名稱。有關外觀的詳細資訊，請參閱“自訂幻想名稱樣式規則”部分。

範例：

NAMEGEN_FIRST_NAMES = [
		("Evennia", 'mf'),
		("Green Tea", 'f'),
	]

NAMEGEN_LAST_NAMES = [ "Beeblebrox", "Son of Odin" ]

NAMEGEN_FANTASY_RULES = {
  "example_style": {
			"syllable": "(C)VC",
			"consonants": [ 'z','z','ph','sh','r','n' ],
			"start": ['m'],
			"end": ['x','n'],
			"vowels": [ "e","e","e","a","i","i","u","o", ],
			"length": (2,4),
	}
}

產生真實姓名

contrib 提供了三個用於產生隨機真實世界名稱的函式： first_name()、last_name() 和 full_name()。如果您想要多個名字 一次生成，可以使用num關鍵字引數來指定多少。

例子：

>>> namegen.first_name(num=5)
['Genesis', 'Tali', 'Budur', 'Dominykas', 'Kamau']
>>> namegen.first_name(gender='m')
'Blanchard'

first_name 函式也採用 gender 關鍵字引數來篩選名稱 由性別協會。 「f」代表女性，「m」代表男性，「mf」代表女性 and 男性，或預設 None 以符合任何性別。

full_name 函式也採用 gender 關鍵字，以及 parts 定義有多少個名字組成全名。最少有兩個：名字和 一個姓氏。您也可以透過設定先生成姓氏的名稱 關鍵字引數 surname_first 到 True

例子：

>>> namegen.full_name()
'Keeva Bernat'
>>> namegen.full_name(parts=4)
'Suzu Shabnam Kafka Baier'
>>> namegen.full_name(parts=3, surname_first=True)
'Ó Muircheartach Torunn Dyson'
>>> namegen.full_name(gender='f')
'Wikolia Ó Deasmhumhnaigh'

新增您自己的名字

您可以使用設定 NAMEGEN_FIRST_NAMES 新增其他名稱，並且 NAMEGEN_LAST_NAMES

NAMEGEN_FIRST_NAMES 應該是元組列表，其中第一個值是名稱 第二個值是性別標誌 - ‘m’ 表示僅限男性，‘f’ 表示女性 - 僅，“mf”代表其中之一。

NAMEGEN_LAST_NAMES 應該是字串列表，其中每個專案都是可用的 姓氏。

範例：

NAMEGEN_FIRST_NAMES = [
		("Evennia", 'mf'),
		("Green Tea", 'f'),
	]

NAMEGEN_LAST_NAMES = [ "Beeblebrox", "Son of Odin" ]

如果您希望上面的自訂清單完全替換內建清單而不是擴充套件它們，請設定NAMEGEN_REPLACE_LISTS = True。

產生幻想名稱

產生完全虛構的名稱是使用 fantasy_name 函式完成的。的 contrib 帶有三種內建的名稱樣式，您可以使用它們，或者您也可以 將自訂名稱規則的字典放入settings.py

產生幻想名稱以規則集鍵為「style」關鍵字，可以 傳回單一名稱或多個名稱。預設情況下，它會回傳一個 內建「嚴厲」風格的單一名稱。 contrib 還帶有“流體”和“外星人”風格。

>>> namegen.fantasy_name()
'Vhon'
>>> namegen.fantasy_name(num=3, style="harsh")
['Kha', 'Kizdhu', 'Godögäk']
>>> namegen.fantasy_name(num=3, style="fluid")
['Aewalisash', 'Ayi', 'Iaa']
>>> namegen.fantasy_name(num=5, style="alien")
["Qz'vko'", "Xv'w'hk'hxyxyz", "Wxqv'hv'k", "Wh'k", "Xbx'qk'vz"]

多字幻想名稱

fantasy_name 函式一次只會產生一個名稱-單字，因此對於多單字名稱 你需要將各個部分組合在一起。根據您想要什麼樣的最終結果，有 幾種方法。

簡單的方法

如果您只需要它具有多個部分，您可以一次產生多個名稱並join它們。

>>> name = " ".join(namegen.fantasy_name(num=2))
>>> name
'Dezhvözh Khäk'

如果您希望名字/姓氏之間有更多變化，您也可以為 不同的風格，然後將它們組合起來。

>>> first = namegen.fantasy_name(style="fluid")
>>> last = namegen.fantasy_name(style="harsh")
>>> name = f"{first} {last}"
>>> name
'Ofasa Käkudhu'

《納庫銀匠》

一種常見的幻想名字實踐是基於職業或頭銜的姓氏。為了達到這個效果， 您可以將 last_name 函式與自訂姓氏清單結合使用，並將其與產生的 幻想的名字。

例子：

NAMEGEN_LAST_NAMES = [ "Silversmith", "the Traveller", "Destroyer of Worlds" ]
NAMEGEN_REPLACE_LISTS = True

>>> first = namegen.fantasy_name()
>>> last = namegen.last_name()
>>> name = f"{first} {last}"
>>> name
'Tözhkheko the Traveller'

埃拉里昂·迪里尼亞，索羅·奧賓森

幻想名字的另一種常見風格是使用姓氏字尾或字首。為此，你將 需要自行增加額外的位元。

範例：

>>> names = namegen.fantasy_name(num=2)
>>> name = f"{names[0]} za'{names[1]}"
>>> name
"Tithe za'Dhudozkok"

>>> names = namegen.fantasy_name(num=2)
>>> name = f"{names[0]} {names[1]}son"
>>> name
'Kön Ködhöddoson'

自訂幻想名稱樣式規則

樣式規則包含在字典的字典中，其中樣式名稱 是鍵，樣式規則是字典值。

以下是將自訂樣式新增至 settings.py 的方法：

NAMEGEN_FANTASY_RULES = {
  "example_style": {
			"syllable": "(C)VC",
			"consonants": [ 'z','z','ph','sh','r','n' ],
			"start": ['m'],
			"end": ['x','n'],
			"vowels": [ "e","e","e","a","i","i","u","o", ],
			"length": (2,4),
	}
}

然後您可以使用 namegen.fantasy_name(style="example_style") 產生遵循該規則集的名稱。

鍵 syllable、consonants、vowels 和 length 必須存在，且 length 必須是最小和最大音節數。 start 和 end 是可選的。

音節

“音節”欄位定義每個音節的結構。 C是子音，V是母音， 和括號表示它是可選的。所以，例子(C)VC意味著每個音節 總是有一個母音後面跟著一個子音，並且有時會有另一個 開頭是子音。 e.g。 en、bak

注意： 雖然它不是標準的，但 contrib 允許您在每一層中巢狀括號 不太可能出現。此外，放入音節中的任何其他字元 結構 - e.g。撇號 - 將以書寫方式讀取和插入。的 模組中的「alien」樣式規則給了兩者的範例：音節結構為C(C(V))(')(C) 這會導致 khq、xho'q 和 q' 等音節的母音頻率比 C(C)(V)(')(C) 會給出。

子音

可供選擇的子音音素的簡單清單。多字元字串是 完全可以接受，例如“th”，但每個都將被視為單一子音。

該函式使用一種簡單的加權形式，使音素更有可能 透過將更多副本放入清單中來發生。

開始和結束

這些是音節第一個和最後一個字母的可選列表（如果它們是） 一個子音。您可以新增只能出現在開頭的附加子音 或音節末尾，或者您可以新增已定義子音的額外副本 增加音節開頭/結尾處的頻率。

例如，在上面的example_style中，我們有m的start，x和n的end。 與其餘子音/母音一起使用，這意味著您可以擁有 mez 的音節 但不能有 zem，並且可以有 phex 或 phen，但不能有 xeph 或 neph。

它們可以完全排除在自訂規則集中。

母音

母音是母音音素的簡單列表 - 與子音完全相同，但用於表示 母音選擇。單字元或多字元字串同樣可以。它使用相同的簡單加權系統 作為子音 - 您可以透過多次將任何給定母音放入清單中來增加其頻率。

長度

具有名稱可以具有的最小和最大音節數的元組。

設定此值時，請記住您的音節可以持續多久！ 4個音節可以 看起來不是很多，但如果你有一個 ©(V)VC 結構，其中一個和 兩個字母的音素，每個音節最多可以包含八個字元。

---

此檔案頁面是從evennia\contrib\utils\name_generator\README.md產生的。對此的更改 檔案將被覆蓋，因此請編輯該檔案而不是此檔案。