Skip to content
What's After the Movie?
Plot summary

The Legend of Hei 2 (2025) Plot Summary & Timeline

The Legend of Hei 2 (2025) movie poster

The Legend of Hei 2 is a 2025 animation and action film directed by MTJJ and Jie Gu, running 2 hours. This page retells the whole story in 1,122 words (about 5 minutes to read) and covers 13 key events in order, 5 characters, where and when it is set and 3 themes. Looking for the cast, ratings and where to stream it? See the movie page for The Legend of Hei 2.

to read the plot summary
5 min
key events in the timeline
13
characters profiled
5
themes explained
3
Loading streaming availability…
The Legend of Hei 2 (2025) movie poster
Released
Runtime
2h
Directors
MTJJ and Jie Gu
Original language
Chinese
Studio
HMCH
No spoilers

What Is The Legend of Hei 2 About?

The premise of The Legend of Hei 2 in 328 words, with nothing given away. The full story follows below.

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.

Full plot

What Happens in The Legend of Hei 2?

The complete story of The Legend of Hei 2, from the first scene to the last, in 1,122 words (about 5 minutes). Spoilers throughout. Names in the text link to 1 cast member page.

Spoilers ahead

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.

Timeline

The Legend of Hei 2 Timeline: Every Key Event in Order

13 key events in the order they happen, from “Ambushed at Liushui Guild Hall” to “A Bittersweet Farewell”. 10 events name a place, across 7 locations.

  1. 1

    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.

    Where:Liushui Guild Hall

  2. 2

    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.

  3. 3

    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.

    Where:Main Hall

  4. 4

    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.

  5. 5

    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.

    Where:Dongqiao Guild Hall

  6. 6

    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.

    Where:Mid-flight

  7. 7

    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.

    Where:Military Base

  8. 8

    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.

    Where:Great Hall

  9. 9

    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.

    Where:Abandoned Steel Mill

  10. 10

    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.

    Where:Abandoned Steel Mill

Show the other 3 events of The Legend of Hei 2
  1. 11

    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.

    Where:Military Base

  2. 12

    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.

    Where:Great Hall

  3. 13

    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.

Characters

Who Are the Main Characters in The Legend of Hei 2?

5 characters, among them Wuxian (Mingyue Liu), Xiaohei and Luye: who each one is and the part they play in the story. 3 of them link to the actor’s page.

  • W(

    Wuxian (Mingyue Liu)

    Played by 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.

    • ⚔️ Bravery
    • 🎓 Protector
    • 🌟 Resilience
  • X

    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.

    • 🌈 Friendship
    • ✨ Growth
    • 🦸‍♂️ Ally
  • L

    Luye

    Played by Lu Li

    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.

    • 🔥 Passion
    • ⚡ Risk-Taker
    • 🌪️ Determination
  • D(

    Diting (Zhenji Huang)

    Played by 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.

    • 🛡️ Loyalty
    • 📜 Strategy
    • 🔍 Observer
  • N

    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.

    • 🐍 Deception
    • 🕵️‍♂️ Antagonist
    • 🧙‍♂️ Powers
Setting

Where and When Is The Legend of Hei 2 Set?

The Legend of Hei 2 is set in Liushui Guild Hall, Dongqiao Guild Hall and Abandoned Steel Mill (Modern Era). Here is why the time and place matter to the story.

When

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.

Where

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.

  • 🏯 Guild
  • 🏭 Industry
  • 🌌 Mystical
Themes

What Are the Themes of The Legend of Hei 2?

3 ideas the story keeps returning to, among them Conflict, Isolation and Coexistence.

  1. 01

    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.

  2. 02

    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.

  3. 03

    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.

Tone & mood

What Kind of Film Is The Legend of Hei 2?

Tense in tone, with variable pacing and a complex story, going by the plot summary.

Tone
Tense
Pacing
Variable
Story
Complex
Intensity
High
Ending
Bittersweet

An action-packed animated fantasy where a young spirit creature and his allies race to clear their master's name amid a sprawling conspiracy, blending martial arts combat, mid-air emergencies, and emotionally complex reconciliation.

  • tense
  • adventurous
  • mysterious
  • political
  • conflicted
  • action-packed
  • political intrigue
  • racial tension
  • framed for crime
  • investigation

Content notes: violence, racial tension, plane crash, combat injuries, framing for crime, military assault.

Quiz

How well do you remember The Legend of Hei 2? Test yourself on the story.

Take the quiz
Loading streaming availability…
Read next

Movies Like The Legend of Hei 2 With a Plot Summary

6 films close to The Legend of Hei 2 in story and themes that have a full plot summary here: L.O.R.D: Legend of Ravaging Dynasties 2 (2020) and Kung Fu Panda 2 (2011) lead. 1 of them comes with the ending explained.

All plot summaries

Missing a Movie Plot Summary?

Tell us which film you want explained next: the full story, the timeline, the characters and the ending.

Request a summary
FAQ

The Legend of Hei 2 Plot Questions

5 quick answers about The Legend of Hei 2, taken from the plot summary, character guide and setting on this page and the film’s credits.

What is The Legend of Hei 2 about?

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…

Read the full plot summary

When and where does The Legend of Hei 2 take place?

The Legend of Hei 2 is set in Liushui Guild Hall, Dongqiao Guild Hall and Abandoned Steel Mill (Modern Era). The movie takes place in a modern context where traditional yaojing culture clashes with rapidly advancing human technology.

The setting explained

Who are the main characters in The Legend of Hei 2?

The story follows Wuxian (Mingyue Liu) (played by Mingyue Liu), Xiaohei, Luye (played by Lu Li) and Diting (Zhenji Huang) (played by Zhenji Huang); the character guide covers 5 characters in all.

All the characters

What are the main themes of The Legend of Hei 2?

The summary picks out 3 themes: Conflict, Isolation and Coexistence.

The themes explained

Who directed The Legend of Hei 2?

The Legend of Hei 2 (2025) was directed by MTJJ and Jie Gu and runs 2 hours.

MTJJ’s films

Coming soon to your phone

The Plot Explained Movie Summary App

From blockbusters to hidden gems: plot summaries, endings explained and timelines on your phone. Save your favorites and never miss a twist again.

Be the first to know when it launches. Your email stays private, always. Learn more about the app