Before we get started on this section, I'd like to take a couple of minutes to talk…
- User
Before we get started on this section, I'd like to take a couple of minutes to talk about some simple
concepts about state management. If you are familiar with using States to control the character's behavior, you can skip this lecture.
Why do we need to use the State Pattern?
In our game, a character usually has multiple conditions.
For example, moving, attacking, hurt, and dead
If we try to manage all of this in one script, it will be quite difficult to keep track of which is the character's current conditions and how to react to them as we add more and more behaviors.
The Structure of State Pattern
The state pattern includes two parts: A State machine and numerous State scripts
The State machineThe state machine is the manager and holds onto all of the states and keeps track of which one is the current state.
The State scripts inherited the StateBase ClassWe'll create a StateBase script as the base class of all of the states, with a few functions in it.
Then, We are going to separate different behaviors into different state scripts that inherits from the StateBase class.
And we'll manage them all together in the StateMachine script.
The Node Structure
We are going to have a StateMachine node under the Character node(the player in this case), with all of the nodes representing different states under it as children nodes. Then we attach a StateMachine script to the StateMachine node, and it's going to keep track of the current state of the player and update the player's behavior based on the current state. The state scripts will be attached to each corresponding state node.The Functions in the StateBase class
We are going to define some functions in the StateBase and the states that inherit the StateBase can override these functions:
The enter() function This function gets called when the StateMachine enters a State, we can do some setup here, such as start playing an animation. The exit() function This function gets called when the StateMachine leaves the current State and enters to a new State, we can do some clear up here, such as disable some VFX or stop the Characters movement. The state_update function This function gets called every frame in the StateMachine script, we can update the Character's behavior in this funciton. The showInfo() function This function only gets called when the game starts, to show us the status of a state. It's used for debugging, and doesn't affect our game.The Functions in the StateMachine script
The _ready() function This function gets called when the game starts, we initialize all of the State scripts in the state children nodes. The _physics_process() function This function is called every frame by the Godot engine. We called the state_update() function(commented above) on the current state, to give it a change to update it's state behavior. The switchTo() function We call the exit() function(commented above) on the current state, then set the current state to the new state. The enter() function(commented above) of the new state will be called.Addinctional data that the State scripts need
The StateMachine that owns this State script
Sometimes the State script needs to talk back to it's owner StateMachine.
The CharacterBody3D node (the PlayerCharacter script)
The State scripts need to update the some properties(such as velocity) of the CharacterBody3D node to change it's behaviors. The State scripts will be getting the input actions from the PlayerCharacter script, as long as the player and enemy's VisualNode, and current health.The AnimationNode of the Character
The State scripts need to have access to the AnimationNode to control the Player and Enemy's animations.
این متن رو میتونی برام به فارسی ترجمه کنی؟؟
- Assistant
البته! در زیر متن به فارسی ترجمه شده است:
قبل از اینکه این بخش را شروع کنیم، میخواهم چند دقیقهای درباره مفاهیم ساده مدیریت وضعیت (State Management) صحبت کنم. اگر با استفاده از States برای کنترل رفتار شخصیتها آشنا هستید، میتوانید این سخنرانی را نادیده بگیرید.
چرا باید از الگوی وضعیت (State Pattern) استفاده کنیم؟
در بازی ما، یک شخصیت معمولاً دارای شرایط متعددی است.
به عنوان مثال، حرکت کردن، حمله کردن، آسیب دیدن و مردن.
اگر بخواهیم همه اینها را با یک اسکریپت مدیریت کنیم، خیلی سخت میشود ردگیری کنیم که وضعیت فعلی شخصیت چیست و چگونه باید به آن واکنش نشان دهیم با اضافه کردن رفتارهای بیشتر و بیشتر.
ساختار الگوی وضعیت (State Pattern)
الگوی وضعیت شامل دو بخش است: یک ماشین وضعیت (State Machine) و اسکریپتهای وضعیت متعدد.
ماشین وضعیت (State Machine)
ماشین وضعیت مدیر است و تمامی وضعیتها را در اختیار دارد و از اینکه وضعیت فعلی کدام است، نگهداری میکند.
اسکریپتهای وضعیت که از کلاس پایه وضعیت (StateBase Class) وراثت میگیرند
ما یک اسکریپت StateBase ایجاد خواهیم کرد به عنوان کلاس پایه تمامی وضعیتها، با چند تابع در آن.
سپس، ما رفتارهای مختلف را به اسکریپتهای وضعیت مختلف جدا میکنیم که از کلاس StateBase وراثت میگیرند.
و همه آنها را در اسکریپت StateMachine مدیریت خواهیم کرد.
ساختار نودها
ما یک نود StateMachine زیر نود Character (در این مورد، بازیکن) خواهیم داشت، با تمامی نودهایی که نمایانگر وضعیتهای مختلف هستند به عنوان نودهای فرزند در زیر آن.
سپس یک اسکریپت StateMachine به نود StateMachine متصل میکنیم. این اسکریپت وضعیت فعلی بازیکن را پیگیری کرده و بر اساس وضعیت فعلی بازیکن، رفتار بازیکن را بهروز میکند.
اسکریپتهای وضعیت به هر نود وضعیت مربوطه متصل میشوند.
توابع در کلاس StateBase
ما قصد داریم چند تابع در StateBase تعریف کنیم و وضعیتهای که از StateBase ارث میبرند، میتوانند این توابع را بازنویسی کنند:
تابع enter() این تابع زمانی که ماشین وضعیت وارد یک وضعیت میشود، فراخوانی میشود. میتوانیم در اینجا برخی تنظیمات انجام دهیم، مانند شروع پخش یک انیمیشن.
تابع exit() این تابع زمانی که ماشین وضعیت وضعیت فعلی را ترک میکند و وارد یک وضعیت جدید میشود، فراخوانی میشود. میتوانیم در اینجا برخی تنظیمات را پاکسازی کنیم، مانند غیرفعال کردن برخی جلوههای ویژه یا توقف حرکت شخصیت.
تابع state_update() این تابع در هر فریم در اسکریپت StateMachine فراخوانی میشود. میتوانیم در این تابع رفتار شخصیت را بهروز کنیم.
تابع showInfo() این تابع تنها زمانی که بازی شروع میشود، فراخوانی میشود تا وضعیت یک وضعیت را به ما نشان دهد. از آن برای دیباگ استفاده میشود و تأثیری بر بازی ندارد.
توابع در اسکریپت StateMachine
تابع _ready() این تابع زمانی که بازی شروع میشود، فراخوانی میشود. ما تمامی اسکریپتهای وضعیت در نودهای فرزند وضعیت را مقداردهی اولیه میکنیم.
تابع _physics_process() این تابع در هر فریم توسط موتور Godot فراخوانی میشود. ما تابع state_update() (کامنت شده در بالا) را روی وضعیت فعلی صدا میزنیم تا بتواند رفتار وضعیت خود را بهروز کند.
تابع switchTo() ما تابع exit() (کامنت شده در بالا) را روی وضعیت فعلی صدا میزنیم، سپس وضعیت فعلی را به وضعیت جدید تنظیم میکنیم. تابع enter() (کامنت شده در بالا) وضعیت جدید فراخوانی خواهد شد.
اطلاعات اضافی که اسکریپتهای وضعیت نیاز دارند
ماشین وضعیت که مالک این اسکریپt وضعیت است
گاه اسکریپت وضعیت نیاز دارد که با ماشین وضعیت خود صحبت کند.
نود CharacterBody3D (اسکریپت PlayerCharacter)
اسکریپتهای وضعیت نیاز دارند که برخی خصوصیات (مانند سرعت) نود CharacterBody3D را بهروز کنند تا رفتارهای آن را تغییر دهد.
اسکریپتهای وضعیت ورودیهای اقدامات را از اسکریپت PlayerCharacter دریافت میکنند، همینطور نود بصری بازیکن و دشمن و سلامتی فعلی را.
نود انیمیشن شخصیت
اسکریپتهای وضعیت نیاز دارند به نود انیمیشن دسترسی داشته باشند تا انیمیشنهای بازیکن و دشمن را کنترل کنند.
- User
به نظرت داخل godot این توضیحاتی که ترجمه کردی کامله؟
- Assistant
توضیحاتی که ارائه شده اصول کلی استفاده از الگوی وضعیت (State Pattern) در بازیسازی با Godot را پوشش میدهد و به طور کلی کامله. با این حال، برای اجرای این مفاهیم، ممکن است نیاز به جزئیات بیشتری داشته باشید. برخی از نقاطی که ممکن است نیاز به توضیح بیشتر داشته باشد عبارتند از:
-
چگونگی پیادهسازی اسکریپتها:
- نمونهسازی واقعی کدها برای ایجاد کلاس StateBase و کلاسهای وراثتیافته از آن.
- نحوه افزودن عملکردهای واقعی برای enter، exit، state_update و showInfo در هر وضعیت.
-
ساختار نودها:
- نحوه ساخت نودهای وضعیت و چگونگی برقراری ارتباط میان آنها.
- چیدن دقیق نودها در پنجرهی صحنه (Scene) در Godot.
-
مدیریت ورودیها و انیمیشنها:
- مثالهای مشخص از چگونگی مدیریت ورودیها (inputs) در اسکریپتها.
- نحوهی استفاده و کنترل انیمیشنها با استفاده از AnimationPlayer یا AnimationTree.
-
ارتباط بین نودها:
- نحوهی دسترسی به نودهای مختلف از طریق کدنویسی و استفاده از سیگنالها (signals) برای ارتباط بین نودها.
در اینجا نمونهای مختصر از کد برای درک بهتر این مفهوم آورده شده است:
تعریف کلاس پایه وضعیت (StateBase)
extends Node class_name StateBase func enter(): pass func exit(): pass func state_update(delta): pass func showInfo(): passتعریف یک وضعیت خاص (مثلاً وضعیت حرکت)
extends StateBase func enter(): print("Entering Move State") # شروع انیمیشن حرکت func exit(): print("Exiting Move State") # توقف انیمیشن حرکت func state_update(delta): # به روز رسانی رفتار حرکتماشین وضعیت (State Machine)
extends Node var currentState = null func _ready(): currentState = $MoveState # شروع با وضعیت حرکت currentState.enter() func _physics_process(delta): if currentState: currentState.state_update(delta) func switchTo(newState): if currentState: currentState.exit() currentState = newState currentState.enter()این نمونهها میتوانند به عنوان نقطه شروع برای شما مفید باشند. همچنین، مطمئن شوید که مستندات Godot را مطالعه کنید و از منابع آموزشی و انجمنها برای حل مشکلات جزئی تر استفاده کنید.
-