mc_sim 0.1.0

A simulator for minecraft speed runs, as that pertains to the Dream cheating scandal.
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

use crate::drop::{DropConfig, Item};
use crate::error::McSimError;
use crate::stats::{BlazeRodDistribution, EnderPearlDistribution};

/// Holds a list of drops and a model of the distribution of those drops.
/// See: [barter_drop_list] and [blaze_drop_list]
#[derive(Debug, Clone)]
pub struct DropList<D>
where
    D: Clone,
{
    list: Vec<DropConfig>,
    distribution: Option<D>,
}

impl<D> DropList<D>
where
    D: Clone,
{
    /// Creates a drop list with a distribution.
    fn new(list: Vec<DropConfig>, distribution: Result<D, McSimError>) -> DropList<D> {
        DropList { list, distribution: distribution.map(|d| Some(d)).unwrap_or(None) }
    }

    /// The list of drop configs, used by drop sims to pick what item to drop.
    pub fn list(&self) -> &[DropConfig] {
        &self.list
    }

    /// A clone of the list of drop configs, used by drop sims to pick what item to drop.
    pub fn list_clone(&self) -> Vec<DropConfig> {
        self.list.clone()
    }

    /// The distribution for the drops in this drop list.
    pub fn distribution(&self) -> &Option<D> {
        &self.distribution
    }
}

/// The drop list for piglin barters in Minecraft 1.16.1
pub fn barter_drop_list(
    ender_pearl_target_total: u32,
    ender_pearl_target_per_run: u32,
) -> DropList<EnderPearlDistribution> {
    let list = vec![
        DropConfig::new(Item::Book, 5, 1, 1),
        DropConfig::new(Item::IronBoots, 8, 1, 1),
        DropConfig::new(Item::Potion, 10, 1, 1),
        DropConfig::new(Item::SplashPotion, 10, 1, 1),
        DropConfig::new(Item::IronNugget, 10, 9, 36),
        DropConfig::new(Item::Quartz, 20, 8, 16),
        DropConfig::new(Item::GlowstoneDust, 20, 5, 12),
        DropConfig::new(Item::MagmaCream, 20, 2, 6),
        DropConfig::new(Item::EnderPearl, 20, 4, 8),
        DropConfig::new(Item::String, 20, 8, 24),
        DropConfig::new(Item::FireCharge, 40, 1, 5),
        DropConfig::new(Item::Gravel, 40, 8, 16),
        DropConfig::new(Item::Leather, 40, 4, 10),
        DropConfig::new(Item::MetherBrick, 40, 4, 16),
        DropConfig::new(Item::Obsidian, 40, 1, 1),
        DropConfig::new(Item::CryingObsidian, 40, 1, 3),
        DropConfig::new(Item::SoulSand, 40, 4, 16),
    ];

    let distribution =
        EnderPearlDistribution::new(ender_pearl_target_total, ender_pearl_target_per_run, &list);

    DropList::new(list, distribution)
}

/// The drop list for blaze fights in Minecraft 1.16.1
pub fn blaze_drop_list(blaze_rod_target: u32) -> DropList<BlazeRodDistribution> {
    let list = vec![DropConfig::new(Item::BlazeRod, 1, 0, 1)];
    let distribution = BlazeRodDistribution::new(blaze_rod_target, &list);

    DropList::new(list, distribution)
}