القدرات في مكتبة وحدة التحكم للشخصيات (CCL) تقييم ما يمكن أن يفعله الشخصية، مثل القدرة على الجري، القفز، التسلق، والسباحة. بدلاً من الاعتماد على حالات الشخصيات المحددة بواسطة المحرك مثل تلك الموجودة في Enum.HumanoidStateType، تتيح مكتبة CCL تركيبات سلوكية مرنة مثل أن تكون الشخصية قادرة على التحرك بينما تستهدف وتنخفض.
تفعيل CCL
The CCL is opt-in through Studio's Avatar Settings window. To enable it:
From the Avatar tab, open Avatar Settings.

Select the Movement tab on the left side of the window and, in the Abilities section, select Character Controller Library.

All of the standard abilities like Running, Jumping, and Climbing are enabled by default. To disable any of them at runtime, uncheck the associated box.
التكوين
أثناء تشغيل لعبتك (أو من خلال نص برمجي يعمل من ServerScriptService)، يمكنك تجربة التكوينات المدمجة للقدرات. يمكنك أيضاً تعديل وحدات التحكم المحددة لضبط المحاكاة الفيزيائية للشخصية وتفاعلها مع البيئة، مثل سرعة الحركة الأساسية للشخصية.
وقت التشغيل
لتجربة تكوينات القدرات في وقت التشغيل:
ابدأ اختبار اللعب.
اختر واحدة من القدرات المدمجة وداخل قسم السمات في نافذة الخصائص، خصص السمات مثل الملاحظات أدناه.
القدرة السمات التسلق - مضاعف السرعة — مضاعف لخاصية ClimbController.MoveSpeedFactor عندما تكون الشخصية تتسلق.
ميت - مفعل — تموت الشخصية عندما يكون الصحة 0 أو أقل.
- الصحة ⇔ Humanoid.Health
- الصحة القصوى ⇔ Humanoid.MaxHealth
- يتطلب الرقبة ⇔ Humanoid.RequiresNeck
اتجاه حركة مواجهة - مفعل ⇔ Humanoid.AutoRotate
السقوط السقوط الحر - مضاعف السرعة — مضاعف لخاصية AirController.MoveSpeedFactor عندما تكون الشخصية في سقوط حر. لاحظ أن التأثير قد يكون خفيفًا عندما تسقط الشخصية لفترة قصيرة جدًا.
القيام القفز - ارتفاع القفزة ⇔ Humanoid.JumpHeight
- قوة القفز ⇔ Humanoid.JumpPower
- استخدام قوة القفز ⇔ Humanoid.UseJumpPower
لا حركة الجري - مضاعف السرعة — مضاعف لخاصية GroundController.MoveSpeedFactor عندما تكون الشخصية تجري.
الجلوس السباحة - تفعيل الارتفاع السريع — ارفع إلى السطح بشكل أسرع عن طريق الإمساك بدخل القفز.
- مضاعف السرعة — مضاعف لخاصية SwimController.MoveSpeedFactor عندما تكون الشخصية تسبح.
النص البرمجي
لتعيين تكوينات القدرات لجميع الشخصيات من خلال نص برمجي:
أنشئ Script جديد على الجانب الخادم داخل ServerScriptService وأعد تسميته إلى AbilitiesScript.
انسخ والصق الكود التالي في النص الجديد. هذا المثال يضاعف سرعة الحركة الأساسية للقدرة الجري بمقدار 2. لا تتردد في ضبط سمات القدرات الأخرى مثل تلك الموصوفة في الجدول أعلاه.
نص برمجي في ServerScriptServicelocal Players = game:GetService("Players")local function onCharacterAdded(character)local AbilityManagerActor = character:WaitForChild("AbilityManagerActor")local Abilities = AbilityManagerActor:WaitForChild("Abilities")local Running = Abilities:FindFirstChild("Running")if Running then-- مضاعفة سرعة الحركة الأساسيةRunning:SetAttribute("مضاعف السرعة", 2)endendlocal function onPlayerAdded(player)if player.Character thenonCharacterAdded(player.Character)endplayer.CharacterAdded:Connect(onCharacterAdded)endPlayers.PlayerAdded:Connect(onPlayerAdded)
