See current US streaming, rental, and purchase options for The Legend of Hei 2 (2025) via JustWatch.
Read the complete plot summary and ending explained for The Legend of Hei 2 (2025). From turning points to emotional moments, uncover what really happened and why it matters.
A powerful yaojing, Master Dasong, along with the members of his Liushui Guild Hall, find themselves under a brutal ambush by human soldiers equipped with advanced weaponry capable of eliminating several yaojing. In the midst of this chaos, Master Dasong confronts an acquaintance before he is tragically killed.
Fast forward two years after the events of the previous installment, and Xiaohei continues to reside with Wuxian. He is diligently enhancing his metal manipulation abilities, trying to reacquire his lost Domain skills, learning Mandarin, and savoring journeys alongside Wuxian. One fateful day, Wuxian receives an invitation to attend a meeting at the Main Hall with the elders of the Yaojing Guild. During their journey to the building, they are joined by Luye, a yaojing and former student of Wuxian.
At the meeting, the elders interrogate Wuxian regarding the attack on Liushui Guild Hall and his recent activities. They have discovered evidence linking the attack to bullets infused with Roumo-wood, a rare, spiritually imbued wood that has mysteriously gone missing from the Guild’s inventory. Furthermore, security footage catches an individual resembling Wuxian leading the attack, deepening the suspicion against him. Despite Wuxian’s staunch denial, he finds it challenging to disprove the claims. He speculates that there might be ulterior motives at play aimed at portraying him, the strongest Enforcer, as a traitor to dismantle the Guild’s defenses. To clear his name, Wuxian proposes to be monitored by NeZha within the Main Hall since he is among the few capable of matching his strength, while the rest of the guild delves into the investigation to uncover the actual perpetrator.
Meanwhile, Luye and Xiaohei embark on their own investigation, albeit under the watchful eyes of two guild members, Jia and Yi. However, Luye cleverly evades them by teleporting to random locations before sabotaging the teleporter to Dongqiao Guild Hall. Her keen senses lead her to detect remnants of spiritual energy and a trail linked to the Roumo-wood taken from Liushui Guild Hall. As they pursue this trail, they encounter a yaojing named Nihuang, who tries to ambush them. It becomes clear that Nihuang was not only involved in the attack but also possesses the ability to shapeshift into other individuals, including Wuxian himself. After capturing Nihuang, they prepare to return to the Main Hall to exonerate Wuxian.
At the same time, Wuxian is occupied in NeZha’s room at the Main Hall, passing his time playing video games, although the tension around him intensifies due to Luye’s bold decision to destroy a teleporter to escape supervision. Efforts to find the culprit continue, leading to the discovery of a military base belonging to the humans responsible for the Liushui Guild Hall attack, where some Roumu-wood is found. In response, Chinan, one of the guild elders, personally leads a mission to confront the base and reclaim the wood.
As Luye and Xiaohei struggle to return to the Main Hall due to the damaged teleporter, they choose to travel by plane to arrive the following day. They are accompanied by Jia and Yi. However, mid-flight, they are ambushed by other yaojings attempting to rescue Nihuang. When these attackers successfully free him, chaos ensues, leading to the destruction of the plane. Amidst this, Luye, Xiaohei, and the injured Jia and Yi manage to safely crash land in the nearby mountains. With Jia and Yi incapacitated, Luye pursues the attackers alone. Xiaohei realizes that Luye’s actions were strategically devised to draw the culprits out, allowing her to track them more effectively, although he chastises her for endangering human lives in the process. Luye, however, is more focused on her goal of taking down the mastermind behind the assault on Liushui Guild Hall.
Meanwhile, the ongoing investigation into the attacked military base has pinpointed the location of a secondary base housing the remaining Roumu-wood. Members from the guild have rushed there to set up a teleporter in the mountains, preparing for a full-scale assault against the humans. Wuxian, witnessing the gathering of Enforcers outside the Great Hall’s teleporter, expresses his desire to participate in the attack to minimize yaojing casualties. However, Chinan dismisses his plan. In a show of unwavering determination, Wuxian halts all Enforcers from passing through the teleporter, leading to a showdown with NeZha that threatens to damage the teleporter. Eventually, Chinan, seeing no other option, permits Wuxian to join the attack.
As Luye continues her pursuit, she tracks Nihuang and his gang to an abandoned steel mill. Here, she faces a challenge as a magical formation prevents her from using her metal powers, despite the abundance of metal around her. Engaging in battle using only her kung-fu, she attempts to dismantle the formation. Suddenly, she encounters Lord Lingyao, a Yaojing Guild elder who dons Dasong’s Liushi Armor. Lingyao unveils his role as the mastermind behind the attack on Liushui Guild Hall and the theft of the Roumu-wood, equipping mercenaries with anti-yaojing weapons. His rationale lies in his belief that the Guild’s complacency with advancing human technology could lead to the yaojing’s downfall. His deception aimed at framing Wuxian as a traitor was part of a plan to incite yaojing outrage against humans.
As the battle rages, Xiaohei appears, using his untapped Space manipulation abilities to aid Luye in dismantling the remaining parts of the magical formation. Despite her injuries, they successfully neutralize Lingyao, who concedes to their strength. However, they soon find themselves engulfed by the explosive aftermath of a magic seal that causes the mill to crumble. While recovering, Xiaohei confronts Luye about her principles, expressing his intention to side with what he perceives as the righteous cause if a war were to arise between yaojings and humans. Luye, unwavering, remains committed to the yaojing cause.
Meanwhile, the Enforcers cross through the teleporter to assist their comrades in survivor efforts against human military fire. Wuxian takes on the military base single-handedly, regaining the Roumu wood while being mistaken for NeZha by the human soldiers due to his casual attire.
Time passes, and Lingyao is now under custody at the Great Hall. Guild elders, including Chinan and Headmaster Yudi, confront Lingyao regarding his actions and the last piece of unexplained Roumu-wood. Lingyao remains tight-lipped, using its absence as leverage to uphold a sliver of peace between yaojings and humans. Although the elders do not endorse Lingyao’s ideology, he cleverly points out their own hypocrisy in keeping his transgressions from public knowledge.
With the shadows of suspicion finally lifted from Wuxian, he returns home alongside Xiaohei. In a reflective moment, Luye observes their happiness and contemplates her past with Wuxian, recognizing that her childhood trauma had forged a wall between her and him. Contented to see them thrive, she bids Wuxian farewell, encouraging him to come visit her in the future.
Follow the complete movie timeline of The Legend of Hei 2 (2025) with every major event in chronological order. Great for understanding complex plots and story progression.
Ambushed at Liushui Guild Hall
Master Dasong and his Liushui Guild Hall members are ambushed by human soldiers equipped with advanced weaponry. During the fray, Dasong confronts an old acquaintance but is ultimately slain, setting off a chain of events that will impact the balance between yaojing and humans.
Life in Training
Two years after the attack, Xiaohei is living with Wuxian, where he practices his metal manipulation skills and studies Mandarin. They enjoy traveling together, but their peaceful life is interrupted when they receive a summons to the Main Hall.
Summoned to the Elders
Upon arriving at the Main Hall, Wuxian and Xiaohei meet with the elders who question Wuxian about the recent attack on Liushui Guild Hall. They present evidence linking Wuxian to the attack, exacerbating the tensions between humans and yaojing.
The Investigation Begins
Wuxian suggests being placed under watch by NeZha to prove his innocence while the guild investigates. Meanwhile, Luye and Xiaohei embark on their own investigation while being monitored by two other yaojings.
Tracking the Spiritual Energy
Luye successfully shakes off her supervisors and teleports to the Dongqiao Guild Hall where she detects spiritual energy residue. This leads her and Xiaohei to discover that Nihuang played a role in the attack on Liushui Guild Hall.
Ambush on a Plane
While attempting to return to the Main Hall by plane, Luye and Xiaohei are ambushed by others attempting to free Nihuang, resulting in a chaotic battle aboard the aircraft. Luye and her team manage to crash land in the mountains but suffer injuries.
Military Base Assault
Chinan leads an attack against the human military base responsible for the original assault on Liushui Guild Hall. The yaojings aim to secure Roumu-wood while fending off human bombings during the construction of their teleporter.
Wuxian's Defiance
Wuxian intervenes and forcibly prevents the Enforcers from using the new teleporter to rush into battle, causing a conflict with Chinan and NeZha. Ultimately, NeZha allows Wuxian to participate in the military base assault after witnessing the escalating standoff.
Confronting the Mastermind
Luye confronts Lord Lingyao at the abandoned steel mill and learns he is the true mastermind behind the attack and the theft of Roumu-wood. Despite being ambushed, she and Xiaohei manage to cripple his magic formation and compel him to surrender.
The Self-Destruct Sequence
As the magic seal triggers a self-destruct mechanism within the mill, Luye and Xiaohei narrowly escape with their lives. This moment forces Xiaohei to question Luye's ruthless tactics and their implications for the fragile relationship between humans and yaojing.
Wuxian's Solo Rescue
Wuxian bravely storms the military base alone amid confusion with NeZha, successfully retrieving the Roumu-wood. His actions, fueled by a desire to save his kind, establish his heroic reputation despite lingering suspicions surrounding his integrity.
Lingyao Stalemate
In a tense confrontation at the Great Hall, Lingyao refuses to disclose the location of the last Roumu-wood, using its absence as leverage to maintain a fragile peace with humans. The elders question the morality of his actions but find themselves caught in a web of hypocrisy.
A Bittersweet Farewell
With Wuxian cleared of wrongdoing and returning home, Luye reflects on her past and the warmth of their shared childhood. As she bids farewell to Wuxian and Xiaohei, she acknowledges her emotional growth and the need for personal changes in her view on humans.
Explore all characters from The Legend of Hei 2 (2025). Get detailed profiles with their roles, arcs, and key relationships explained.
Wuxian (Mingyue Liu)
Wuxian is a central character, skilled in metal manipulation, who navigates the duality of his identity as a yaojing Enforcer. He is loyal, resourceful, and demonstrates a deep sense of responsibility towards both his guild and the humans. Wuxian's struggle against suspicion showcases his determination and moral complexity.
Xiaohei
Xiaohei is Wuxian's companion who displays a strong sense of moral integrity and curiosity. He is shown to have latent powers and is vital in supporting Luye during critical moments. His development reflects the evolving dynamics of friendship and the importance of choosing the right side in conflicts.
Luye
Luye, a determined and headstrong yaojing, strives to prove herself and protect her kind, often leading her to take drastic measures. Driven by her past and trauma, her character is complex, showing a fierce allegiance to her people, but also prompting questions about her ethics and methods.
Diting (Zhenji Huang)
Diting is a member of the guild, whose role involves supporting investigations and maintaining order. His character embodies loyalty to the guild but also shows how guild politics can complicate personal motivations.
Nihuang
Nihuang is a cunning adversary with the ability to shapeshift, complicating the conflict as he embodies the threat to the yaojing realm. His actions prompt the protagonists to confront their greatest fears about betrayal and trust.
Learn where and when The Legend of Hei 2 (2025) takes place. Explore the film’s settings, era, and how they shape the narrative.
Time period
Modern Era
The movie takes place in a modern context where traditional yaojing culture clashes with rapidly advancing human technology. This period is characterized by tensions between supernatural beings and humanity, highlighting the struggle for coexistence amidst advancing military capabilities.
Location
Liushui Guild Hall, Dongqiao Guild Hall, Abandoned Steel Mill
Liushui Guild Hall serves as a central hub for yaojing and is known for its spiritual significance and its connection to traditional yaojing lore. The Dongqiao Guild Hall is a location associated with governance and oversight of the yaojing community. The Abandoned Steel Mill plays a critical role in the story, serving as a battleground where ancient powers collide with industrialization, reflecting the themes of conflict between yaojings and humans.
Discover the main themes in The Legend of Hei 2 (2025). Analyze the deeper meanings, emotional layers, and social commentary behind the film.
⚔️
Conflict
The theme of conflict is central to the film, captured in the struggle between the yaojings and humans. The narrative showcases the escalating tensions that arise from misunderstandings and the misuse of power. It emphasizes moral dilemmas faced by characters, particularly in their dual loyalties to their species and to humanity.
💔
Isolation
Isolation is a significant theme, as seen in Luye's character, who grapples with her bitterness towards humans due to past traumas. This isolation affects her relationships and decisions, highlighting the emotional struggles that arise from the conflict. The theme suggests that personal experiences shape perspectives and influence action.
🤝
Coexistence
The desire for coexistence between yaojings and humans is poignantly explored in the film. Characters face the challenge of bridging cultural divides and prejudices. Wuxian's journey embodies hope for collaboration and understanding, pushing against a backdrop of animosity and fear.

Coming soon on iOS and Android
From blockbusters to hidden gems — dive into movie stories anytime, anywhere. Save your favorites, discover plots faster, and never miss a twist again.
Sign up to be the first to know when we launch. Your email stays private — always.
Explore the mobile appDiscover the spoiler-free summary of The Legend of Hei 2 (2025). Get a concise overview without any spoilers.
In a world where spirits and humans exist side by side, a fragile truce has long kept the two realms separated yet at peace. This delicate balance hums quietly beneath the surface of everyday life, a sacred oath maintained by those who have pledged themselves to guarding the boundary between worlds. Tension lingers just out of sight, and any disturbance threatens to unravel the harmony that both peoples have worked to preserve.
At the heart of this story is Hei, a spirited young yaojing still learning the extent of his own powers, who lives and trains under the guidance of his adoptive master, Shifu Wuxian. Their bond is one of warmth and quiet devotion, shaped by years of shared wandering and patient teaching. Into their world steps Luye, Wuxian’s final pupil — a capable, determined yaojing with a sharp mind and a deep connection to her teacher’s legacy. Though her relationship with Wuxian carries the weight of history, her partnership with Hei forges something new: a shared resolve to face the dangers ahead.
That danger arrives when a sudden assault shatters the long-standing peace, exposing fault lines between the spirit realm and humanity that were never fully healed. Old wounds resurface, and suspicions rise among the yaojing elders, casting shadows over those they once trusted. The incident is no ordinary breach — it hints at a hidden plot, carefully orchestrated, that endangers not only both worlds but the very oath that has kept them apart.
Together, Hei and Luye set out to untangle the threads of this conspiracy, drawing on Wuxian’s teachings and their own complementary strengths. As they follow the trail, the film unfolds as a visually rich, emotionally layered adventure that blends mystical wonder with the quiet gravity of a world on the edge of transformation. Their journey becomes not just an investigation, but a test of loyalty, identity, and what it truly means to protect a peace that was never as solid as it seemed.
Uncover films that echo the narrative beats, emotional arcs, or dramatic twists of the one you're exploring. These recommendations are handpicked based on story depth, thematic resonance, and spoiler-worthy moments — perfect for fans who crave more of the same intrigue.
What's After the Movie?
Not sure whether to stay after the credits? Find out!
Check out our other apps:
SAT Sphere
Build confidence for the Digital SAT.
Mori Atlas
Discover wild places worth protecting.
Luntero
Search smarter for a home in Amsterdam.
Plot Explained
Unravel movie endings and hidden clues.
Pokechamp
Dive into Pokémon data and battle logic.
Driving Theory
Get ready for your European theory test.
Movie Dust
Plan your next cinema trip with ease.
Musemap
Find art and culture as you travel.
Selkobase
Compare credentials before committing.
Local Manual
Turn an unfamiliar country into practical next steps.
Lernavi
Compare school systems before your next move.
GymRoam
Find a workout stop wherever your plans take you.
Explore Our Movie Platform
New Movie Releases (2026)
Famous Movie Actors
Top Film Production Studios
Movie Plot Summaries & Endings
Major Movie Awards & Winners
Best Concert Films & Music Documentaries
Movie Collections and Curated Lists
© 2026 What's After the Movie. All rights reserved.
Privacy Policy