--[[ سكربت مدمج للشخصية غير اللاعبة (NPC) - يتجول بين نقاط محددة (waypoints). - يتوقف ويشغل أنيميشن الوقوف عند اقتراب لاعب. - يتفاعل (مع أنيميشن) عند لمس اللاعب له مباشرة. - يربط أنيميشن المشي/الوقوف بالحركة الفعلية. المتطلبات: 1. نموذج NPC يحتوي على Humanoid, HumanoidRootPart, Animator. 2. مجلد "WaypointsFolder" في Workspace يحتوي على Parts باسم "Waypoint1", "Waypoint2", ... 3. يجب استبدال معرفات الأنيميشن (Animation IDs) أدناه. ]] local npc = script.Parent local humanoid = npc:WaitForChild("Humanoid") local rootPart = npc:WaitForChild("HumanoidRootPart") local animator = humanoid:WaitForChild("Animator") local playersService = game:GetService("Players") local runService = game:GetService("RunService") -- ===== إعدادات ===== local waypointsFolderName = "WaypointsFolder" local numberOfWaypoints = 8 -- العدد المتوقع للنقاط (سيتم تحديثه إذا كان أقل) local detectionRadius = 50 -- مدى كشف اللاعب للتوقف local movementTimeout = 15 -- أقصى وقت انتظار للوصول للنقطة local checkInterval = 0.2 -- الفاصل الزمني للحلقة الرئيسية (أسرع قليلاً للاستجابة) local retryDelay = 1 -- تأخير إعادة محاولة الوصول لنفس النقطة -- <<== استبدل بالـ IDs الصحيحة لأنيميشناتك ==>> local WALK_ANIMATION_ID = "rbxassetid://139807428535351" -- مثال: أنيميشن مشي local IDLE_ANIMATION_ID = "rbxassetid://139807428535351" -- مثال: أنيميشن وقوف (استخدم ID مختلف!) local INTERACTION_ANIMATION_ID = "rbxassetid://133212607109891" -- مثال: أنيميشن تفاعل -- <<=========================================>> local INTERACTION_COOLDOWN_AFTER_ANIM = 1 -- كول داون قصير بعد انتهاء أنيميشن التفاعل (بالثواني) -- ===== تحميل الأنيميشن ===== local function loadAnimation(name, id, looped, priority) local animation = Instance.new("Animation") animation.Name = name animation.AnimationId = id animation.Parent = npc -- ربطه بالـ NPC لتسهيل التنظيف local track = animator:LoadAnimation(animation) track.Looped = looped track.Priority = priority return track, animation -- إرجاع التراك والأنيميشن نفسه للتنظيف end local walkAnimationTrack, walkingAnimation = loadAnimation("WalkingAnimation", WALK_ANIMATION_ID, true, Enum.AnimationPriority.Core) local idleAnimationTrack, idleAnimation = loadAnimation("IdleAnimation", IDLE_ANIMATION_ID, true, Enum.AnimationPriority.Idle) -- أولوية أقل للمشي local interactionTrack, interactionAnimation = loadAnimation("InteractionAnimation", INTERACTION_ANIMATION_ID, false, Enum.AnimationPriority.Action) -- ===== إعداد النقاط ===== local waypointsFolder = workspace:WaitForChild(waypointsFolderName, 10) -- انتظر 10 ثواني local waypoints = {} if waypointsFolder then for i = 1, numberOfWaypoints do local waypoint = waypointsFolder:FindFirstChild("Waypoint" .. i) if waypoint and waypoint:IsA("BasePart") then table.insert(waypoints, waypoint) else warn("لم يتم العثور على Waypoint" .. i .. " أو أنه ليس BasePart في " .. waypointsFolderName) end end if #waypoints < numberOfWaypoints and #waypoints > 0 then warn("تم العثور على " .. #waypoints .. " نقاط فقط بدلاً من " .. numberOfWaypoints .. ". سيستمر السكربت بالنقاط الموجودة.") numberOfWaypoints = #waypoints -- استخدم العدد الفعلي للنقاط الموجودة end else warn("لم يتم العثور على مجلد النقاط: " .. waypointsFolderName .. " خلال 10 ثواني.") end if #waypoints == 0 then warn("لم يتم العثور على أي نقاط مسار صالحة. سيتم تعطيل السكربت.") script.Disabled = true return -- أوقف تنفيذ السكربت end -- ===== متغيرات الحالة ===== local currentWaypointIndex = 1 local patrolMode = "sequential" -- "sequential" أو "random" local isStoppedDueToPlayer = false local isInteracting = false local interactionDebounce = false local movementInterrupted = false -- لتتبع ما إذا تم إيقاف الحركة الحالية (بسبب لاعب أو تفاعل أو فشل) local currentTargetWaypoint = nil -- لتتبع الوجهة الحالية بوضوح -- ===== الدوال المساعدة ===== -- دالة للتحقق من وجود لاعبين قريبين local function isPlayerNearby() local npcPosition = rootPart.Position for _, player in ipairs(playersService:GetPlayers()) do local character = player.Character -- تأكد أن اللاعب لديه شخصية، وأنها ليست الـ NPC نفسه، وأن اللاعب حي if character and character ~= npc then local playerRoot = character:FindFirstChild("HumanoidRootPart") local playerHumanoid = character:FindFirstChildOfClass("Humanoid") if playerRoot and playerHumanoid and playerHumanoid.Health > 0 then if (playerRoot.Position - npcPosition).Magnitude <= detectionRadius then return true -- تم العثور على لاعب قريب end end end end return false -- لا يوجد لاعبون قريبون end -- دالة لإيقاف حركة وأنيميشن الـ NPC بسبب لاعب local function stopMovementDueToPlayer() if not isStoppedDueToPlayer then print("لاعب قريب! إيقاف الحركة.") isStoppedDueToPlayer = true movementInterrupted = true -- إشارة إلى أن الحركة الحالية يجب أن تتوقف humanoid:MoveTo(rootPart.Position) -- أمر بالتوقف في المكان الحالي currentTargetWaypoint = nil -- لم نعد نتحرك نحو نقطة -- سيتم تحديث الأنيميشن (إلى الوقوف) بواسطة updateAnimationState end end -- دالة لاستئناف حركة الـ NPC (بعد ابتعاد اللاعب) local function resumeMovementAfterPlayerLeft() if isStoppedDueToPlayer then print("ابتعد اللاعبون. استعداد لاستئناف الحركة.") isStoppedDueToPlayer = false -- الحلقة الرئيسية ستتعامل مع استئناف الحركة والأنيميشن -- سيتم تحديث الأنيميشن (إلى الوقوف أو المشي) بواسطة updateAnimationState end end -- دالة لاختيار النقطة التالية (فقط بعد الوصول أو تغيير الوضع) local function selectNextWaypoint() local previousIndex = currentWaypointIndex if patrolMode == "sequential" then currentWaypointIndex = currentWaypointIndex + 1 if currentWaypointIndex > #waypoints then print("اكتمل المسار التسلسلي. التبديل إلى الوضع العشوائي.") patrolMode = "random" -- اختر نقطة عشوائية مختلفة عن الأخيرة في التسلسل repeat currentWaypointIndex = math.random(1, #waypoints) until currentWaypointIndex ~= previousIndex or #waypoints == 1 end elseif patrolMode == "random" then -- اختر نقطة عشوائية مختلفة عن الحالية repeat currentWaypointIndex = math.random(1, #waypoints) until currentWaypointIndex ~= previousIndex or #waypoints == 1 end currentTargetWaypoint = waypoints[currentWaypointIndex] print("النقطة التالية المحددة: Waypoint " .. currentWaypointIndex .. " (" .. patrolMode .. ")") return currentTargetWaypoint end -- دالة لتحديث حالة الأنيميشن (مشي/وقوف) local function updateAnimationState() -- لا تغير الأنيميشن إذا كان التفاعل نشطًا if isInteracting then if walkAnimationTrack.IsPlaying then walkAnimationTrack:Stop() end if idleAnimationTrack.IsPlaying then idleAnimationTrack:Stop() end return end -- تحقق مما إذا كان يجب أن يكون واقفًا (بسبب لاعب أو لا يتحرك) local shouldBeIdle = isStoppedDueToPlayer or humanoid.MoveDirection.Magnitude < 0.1 if shouldBeIdle then if walkAnimationTrack.IsPlaying then walkAnimationTrack:Stop() -- print("إيقاف أنيميشن المشي.") end if not idleAnimationTrack.IsPlaying then idleAnimationTrack:Play() -- print("تشغيل أنيميشن الوقوف.") end else -- يجب أن يكون ماشيًا if idleAnimationTrack.IsPlaying then idleAnimationTrack:Stop() -- print("إيقاف أنيميشن الوقوف.") end if not walkAnimationTrack.IsPlaying then walkAnimationTrack:Play() -- print("تشغيل أنيميشن المشي.") end end end -- ===== منطق التفاعل عند اللمس ===== local function onTouch(hit) -- لا تتفاعل إذا كان الكول داون نشطًا أو يتفاعل بالفعل أو متوقف بسبب لاعب (لتجنب سلوك غريب) if interactionDebounce or isInteracting or isStoppedDueToPlayer then return end local character = hit.Parent local player = character and playersService:GetPlayerFromCharacter(character) -- تحقق مما إذا كان الجزء الملموس ينتمي إلى لاعب حي وليس الـ NPC نفسه if player and character ~= npc then local playerHumanoid = character:FindFirstChildOfClass("Humanoid") if playerHumanoid and playerHumanoid.Health > 0 then print("تم لمس الـ NPC بواسطة اللاعب: " .. player.Name) interactionDebounce = true -- ابدأ الكول داون المؤقت للمس isInteracting = true -- إشارة إلى أن الـ NPC مشغول بالتفاعل movementInterrupted = true -- أوقف أي حركة حالية currentTargetWaypoint = nil -- لم نعد نتحرك نحو نقطة -- أوقف الحركة فوراً humanoid:MoveTo(rootPart.Position) -- إيقاف أنيميشن المشي والوقوف updateAnimationState() -- سيقوم هذا بإيقاف الأنيميشن المناسب -- تشغيل أنيميشن التفاعل وانتظار انتهائه print("بدء أنيميشن التفاعل.") interactionTrack:Play() -- انتظر حتى ينتهي الأنيميشن (استخدم Signal:Wait() فهو أكثر أمانًا) local success, err = pcall(function() interactionTrack.Stopped:Wait() end) if not success then warn("حدث خطأ أثناء انتظار انتهاء أنيميشن التفاعل: " .. tostring(err)) -- قد يكون الأنيميشن توقف لسبب آخر (مثل موت الـ NPC) end print("انتهاء أنيميشن التفاعل.") -- إعادة تعيين حالة التفاعل isInteracting = false -- سيتم تحديث الأنيميشن (إلى الوقوف) بواسطة updateAnimationState في الحلقة الرئيسية -- انتظر قليلاً قبل السماح بتفاعل جديد باستخدام task.delay لتجنب إيقاف الخيط task.delay(INTERACTION_COOLDOWN_AFTER_ANIM, function() interactionDebounce = false -- اسمح بتفاعل جديد print("الـ NPC متاح للتفاعل مرة أخرى.") end) end end end -- ربط دالة اللمس rootPart.Touched:Connect(onTouch) -- ===== الحلقة الرئيسية للدوريات والكشف والأنيميشن ===== local function mainLoop() print("بدء الحلقة الرئيسية للـ NPC.") -- شغل أنيميشن الوقوف في البداية idleAnimationTrack:Play() currentTargetWaypoint = waypoints[currentWaypointIndex] -- تحديد الهدف الأول while npc.Parent and humanoid.Health > 0 do local playerIsNear = isPlayerNearby() -- 1. التعامل مع حالة التوقف/الاستئناف بسبب اللاعب (فقط إذا لم نكن نتفاعل) if not isInteracting then if playerIsNear and not isStoppedDueToPlayer then stopMovementDueToPlayer() elseif not playerIsNear and isStoppedDueToPlayer then resumeMovementAfterPlayerLeft() -- قد نحتاج إلى إعادة تحديد الهدف إذا تمت مقاطعة الحركة السابقة if not currentTargetWaypoint then currentTargetWaypoint = waypoints[currentWaypointIndex] print("إعادة تحديد الهدف بعد ابتعاد اللاعب: Waypoint " .. currentWaypointIndex) end end end -- 2. محاولة التحرك فقط إذا لم نكن متوقفين بسبب لاعب ولم نكن نتفاعل if not isStoppedDueToPlayer and not isInteracting then if currentTargetWaypoint then -- تحقق مما إذا كنا قد وصلنا بالفعل (أو قريبين جدًا) لتجنب استدعاء MoveTo بشكل متكرر if (rootPart.Position - currentTargetWaypoint.Position).Magnitude > 2 then -- مسافة صغيرة للتحقق print("التحرك نحو Waypoint " .. currentWaypointIndex .. " (" .. patrolMode .. ")") movementInterrupted = false -- إعادة تعيين علامة المقاطعة قبل بدء الحركة humanoid:MoveTo(currentTargetWaypoint.Position) -- انتظر نتيجة MoveTo (مع مهلة ومقاطعة) local moveToFinishedConnection local reachedTarget = false local finished = false moveToFinishedConnection = humanoid.MoveToFinished:Connect(function(reached) if moveToFinishedConnection then moveToFinishedConnection:Disconnect() end moveToFinishedConnection = nil if not movementInterrupted then -- تجاهل النتيجة إذا تمت مقاطعة الحركة reachedTarget = reached finished = true if not reachedTarget then warn("MoveToFinished أبلغ عن فشل الوصول إلى Waypoint " .. currentWaypointIndex) end else print("تم تجاهل MoveToFinished بسبب مقاطعة.") finished = true -- اعتبرها منتهية بسبب المقاطعة end end) -- حلقة الانتظار local waitStartTime = os.clock() while not finished and not movementInterrupted and not isInteracting and not isStoppedDueToPlayer and (os.clock() - waitStartTime < movementTimeout) do -- لا حاجة لتحديث الأنيميشن هنا، سيتم تحديثه في نهاية الحلقة الرئيسية task.wait() -- انتظر الإطار التالي end -- تنظيف الاتصال إذا لم ينته الحدث بعد (بسبب المهلة أو مقاطعة أخرى) if moveToFinishedConnection then moveToFinishedConnection:Disconnect() moveToFinishedConnection = nil if not finished then -- إذا لم ينته الحدث، فهذا يعني مهلة أو مقاطعة لم يتم اكتشافها مباشرة print("انتهاء الانتظار (مهلة أو مقاطعة غير مكتشفة بواسطة الحدث).") movementInterrupted = true -- اعتبرها مقاطعة end end -- تقييم النتيجة بعد الانتظار if movementInterrupted or isInteracting or isStoppedDueToPlayer then print("تمت مقاطعة الحركة إلى Waypoint " .. currentWaypointIndex) currentTargetWaypoint = nil -- فقدنا الهدف الحالي بسبب المقاطعة -- لا تغير currentWaypointIndex هنا، سيتم إعادة المحاولة أو اختيار نقطة جديدة لاحقًا elseif reachedTarget then print("تم الوصول بنجاح إلى Waypoint " .. currentWaypointIndex) currentTargetWaypoint = selectNextWaypoint() -- اختر النقطة التالية else -- فشل الوصول (إما MoveToFinished(false) أو انتهاء المهلة) warn("فشل الوصول أو انتهت مهلة الحركة إلى Waypoint " .. currentWaypointIndex .. ". إعادة المحاولة بعد تأخير.") humanoid:MoveTo(rootPart.Position) -- أوقف محاولة الحركة الحالية currentTargetWaypoint = nil -- فقدنا الهدف الحالي task.wait(retryDelay) -- أعد تحديد نفس الهدف للمحاولة مرة أخرى في الدورة التالية currentTargetWaypoint = waypoints[currentWaypointIndex] print("إعادة محاولة الوصول إلى Waypoint " .. currentWaypointIndex) end else -- قريب جدًا من الهدف، اعتبره وصولاً print("قريب جدًا من Waypoint " .. currentWaypointIndex .. "، اعتباره وصولاً.") currentTargetWaypoint = selectNextWaypoint() -- اختر النقطة التالية end else -- لا يوجد هدف حالي (ربما بسبب مقاطعة سابقة أو خطأ) warn("لا يوجد هدف حالي. محاولة تحديد النقطة التالية.") currentTargetWaypoint = selectNextWaypoint() task.wait(0.5) -- انتظر قليلاً قبل المحاولة مرة أخرى end end -- 3. تحديث حالة الأنيميشن بناءً على الحالة الحالية (يجب أن يكون ماشيًا، واقفًا، إلخ) updateAnimationState() -- 4. انتظر قبل الدورة التالية للحلقة الرئيسية task.wait(checkInterval) end print("توقف سكربت الـ NPC (مات أو تمت إزالته).") -- سيتم استدعاء دالة التنظيف Destroying تلقائيًا end -- ===== التنظيف عند حذف الـ NPC ===== npc.Destroying:Connect(function() print("تنظيف سكربت الـ NPC...") -- إيقاف وتدمير كل الأنيميشن if walkAnimationTrack then walkAnimationTrack:Stop(); walkAnimationTrack:Destroy() end if walkingAnimation then walkingAnimation:Destroy() end if idleAnimationTrack then idleAnimationTrack:Stop(); idleAnimationTrack:Destroy() end if idleAnimation then idleAnimation:Destroy() end if interactionTrack then interactionTrack:Stop(); interactionTrack:Destroy() end if interactionAnimation then interactionAnimation:Destroy() end -- يمكنك إضافة أي تنظيف آخر هنا (مثل فصل الاتصالات المتبقية إن وجدت) end -- ===== بدء التشغيل ===== -- تأكد من أن الـ NPC لم يتم تدميره بالفعل قبل بدء التشغيل if npc.Parent and humanoid.Health > 0 then task.spawn(mainLoop) -- ابدأ الحلقة الرئيسية في خيط منفصل print("تم تهيئة سكربت الـ NPC المدمج بنجاح مع " .. #waypoints .. " نقاط مسار.") else warn("لا يمكن بدء سكربت الـ NPC (إما تمت إزالته أو مات قبل البدء).") script.Disabled = true end