nil-core 0.6.7

Multiplayer strategy game
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

// Copyright (C) Call of Nil contributors
// SPDX-License-Identifier: AGPL-3.0-only

use crate::chat::ChatMessage;
use crate::continent::coord::Coord;
use crate::error::Result;
use crate::event::{Event, Listener};
use crate::military::maneuver::ManeuverId;
use crate::player::PlayerId;
use crate::report::ReportKind;
use crate::report::battle::BattleReport;
use crate::report::support::SupportReport;
use crate::world::World;
use std::collections::HashSet;

impl World {
  #[inline]
  pub fn subscribe(&self) -> Listener {
    self.emitter.subscribe()
  }

  /// Emits the event to all players.
  fn broadcast(&self, event: Event) -> Result<()> {
    self.emitter.broadcast(event)
  }

  /// Emits the event for a specific player.
  fn emit_to(&self, target: PlayerId, event: Event) -> Result<()> {
    self.emitter.emit_to(target, event)
  }

  /// Emits the event to the owner of the city at the specified coordinate, if any.
  fn emit_to_city_owner(&self, coord: Coord, event: Event) -> Result<()> {
    let city = self.city(coord)?;
    if let Some(player) = city.player() {
      self.emitter.emit_to(player.clone(), event)?;
    }

    Ok(())
  }

  /// Emits [`Event::ChatMessage`].
  pub(super) fn emit_chat_message(&self, message: ChatMessage) -> Result<()> {
    let world = self.config.id();
    self.broadcast(Event::ChatMessage { world, message })
  }

  /// Emits [`Event::City`] to the city owner.
  pub(super) fn emit_city(&self, coord: Coord) -> Result<()> {
    let world = self.config.id();
    self.emit_to_city_owner(coord, Event::City { world, coord })
  }

  /// Emits [`Event::Drop`].
  /// This should never be called manually.
  pub(super) fn emit_drop(&self) -> Result<()> {
    let world = self.config.id();
    self.broadcast(Event::Drop { world })
  }

  /// Emits [`Event::Military`].
  pub(super) fn emit_military(&self, player: PlayerId) -> Result<()> {
    let world = self.config.id();
    self.emit_to(player.clone(), Event::Military { world, player })
  }

  /// Emits [`Event::Military`] to all players participating in the specified maneuver.
  pub(super) fn emit_military_to_maneuver_players(&self, id: ManeuverId) -> Result<()> {
    let maneuver = self.military.maneuver(id)?;
    let mut players = HashSet::with_capacity(3);

    if let Some(player) = self
      .military
      .army(maneuver.army())?
      .owner()
      .player()
    {
      players.insert(player);
    }

    if let Some(player) = self.city(maneuver.origin())?.player() {
      players.insert(player);
    }

    if let Some(player) = self.city(maneuver.destination())?.player() {
      players.insert(player);
    }

    for player in players {
      self.emit_military(player.clone())?;
    }

    Ok(())
  }

  /// Emits [`Event::Player`].
  pub(super) fn emit_player(&self, player: PlayerId) -> Result<()> {
    let world = self.config.id();
    self.emit_to(player.clone(), Event::Player { world, player })
  }

  /// Emits [`Event::PublicCity`] **and** [`Event::City`].
  pub(super) fn emit_public_city(&self, coord: Coord) -> Result<()> {
    let world = self.config.id();
    self.broadcast(Event::PublicCity { world, coord })?;
    self.emit_city(coord)?;
    Ok(())
  }

  /// Emits [`Event::Report`].
  pub(super) fn emit_report(&self, player: PlayerId, report: ReportKind) -> Result<()> {
    let world = self.config.id();
    self.emit_to(player, Event::Report { world, report: Box::new(report) })
  }

  pub(super) fn emit_battle_report(&self, report: &BattleReport) -> Result<()> {
    let mut players = HashSet::with_capacity(2);
    if let Some(player) = report.attacker().player() {
      players.insert(player);
    }

    if let Some(player) = report.defender().player() {
      players.insert(player);
    }

    for player in players {
      self.emit_report(player.clone(), report.clone().into())?;
    }

    Ok(())
  }

  pub(super) fn emit_support_report(&self, report: &SupportReport) -> Result<()> {
    let mut players = HashSet::with_capacity(2);
    if let Some(player) = report.sender().player() {
      players.insert(player);
    }

    if let Some(player) = report.receiver().player() {
      players.insert(player);
    }

    for player in players {
      self.emit_report(player.clone(), report.clone().into())?;
    }

    Ok(())
  }

  /// Emits [`Event::Round`].
  pub(super) fn emit_round(&self) -> Result<()> {
    let world = self.config.id();
    let round = self.round.clone();
    self.broadcast(Event::Round { world, round })
  }
}