NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1782 by repository stars
Latest stable
v1.11.0
Last release 6 years ago
no release in 18 months
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 42 of 42 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
61 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
This is just a bugfix release, please upgrade to v2.x if you have the chance. As of the time of this release, the newest version is v2.2.0
This is just a bugfix release, please upgrade to v2.x if you have the chance. As of the time of this release, the newest version is v2.2.0
Parser.Close() to fix a memory leak due to an unterminated goroutine (#216)
please make sure that this function is called before the parser is discarded,
for instance by calling defer parser.Close() after demoinfocs.NewParser()Changed panicking behaviour partially back to pre-v1.8.0 to improve debugging experience
v1.8.0 to improve debugging experience (#200)msgQueue size (when setting ParserConfig.MsgQueueSize=-1) to the range of 50'000 to 500'000
This fixes an issue where some demos would have a queue size of 0, leading to degraded performance (happened if DemoHeader.PlaybackTicks was 0).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Fixed issue where player's weapons were sometimes not instantiated correctly (EqUnknonwn) - (#197 - thanks @BestAwperEver)
EqUnknonwn) - (#197 - thanks @BestAwperEver)Added GameState.Weapons() function which returns all currently existing weapon instances as a map[int]*Equipment where the key is the entityID (#195 -
GameState.Weapons() function which returns all currently existing weapon instances as a map[int]*Equipment where the key is the entityID (#195 - thanks @BestAwperEver)Avoid suppressing panics inside consumer code (e.g. RegisterEventHandler) (#190) This was accidentally done since 1.8.0 and made debugging errors in e
RegisterEventHandler) (#190)
This was accidentally done since 1.8.0 and made debugging errors in event or net-message handlers much harderDeprecated DemoHeader.TickRate()
DemoHeader.TickRate()DemoHeader.TickTime()Parser.TickRate()Parser.TickTime()CSVCMsg_ServerInfo for tick-rate etc. in case of corrupted demo headers with missing data (#184)Player.FlashTimeRemaining() that caused inaccurate calculation of the flash time in some rare casesFixed EqUnknown for molotovs in some newer demos (#187 - thanks @BestAwperEver)
EqUnknown for molotovs in some newer demos (#187 - thanks @BestAwperEver)Fixed panic Bombsite with index 260 not found for certain demos (#180 - thanks @vidosits)
Bombsite with index 260 not found for certain demos (#180 - thanks @vidosits)Fixed knifes being treated as EqUnknown in some cases (#179 - thanks @BestAwperEver)
EqUnknown in some cases (#179 - thanks @BestAwperEver)Fixed Inferno.Thrower being nil in some cases (#176 / #177 - thanks @BestAwperEver)
Inferno.Thrower being nil in some cases (#176 / #177 - thanks @BestAwperEver)Reverted delaying of decoy_expired event introduced in v1.7.1 (#171 - thanks @BestAwperEver) Instead we just delay the deletion of the thrownGrenades
decoy_expired event introduced in v1.7.1 (#171 - thanks @BestAwperEver)
Instead we just delay the deletion of the thrownGrenades entryFixed PlayerHurt.WeaponInstance being nil in some cases
PlayerHurt.WeaponInstance being nil in some cases (#171)EqUnknown)Player.Entity may be nil between the player's death and his re-spawn (#170)Player fields may be nil (#172)Player.ViewDirection{X,Y} ranges (#116)Deprecated Inferno.Owner() in favour of Inferno.Thrower()
Inferno.Owner() in favour of Inferno.Thrower()GrenadeEvent.GrenadeGrenadeProjectile.WeaponInstancePlayer.IsControllingBot()Player.ControlledBot()IParticipants.AllByUserID() (#167 - thanks @BestAwperEver)Fixed PlayerFlashed.Projectile.Owner and PlayerFlashed.Projectile.Weapon being incorrect in some cases
PlayerFlashed.Projectile.Owner and PlayerFlashed.Projectile.Weapon being incorrect in some casesAdded PlayerFlashed.Projectile, contains a reference to the flashbang's GrenadeProjectile
PlayerFlashed.Projectile, contains a reference to the flashbang's GrenadeProjectile (#158)nil pointer dereference panic that occurred in some demos after the Operation Shattered Web update (#162 / #165)
Some players may now be "unknown" which can be dected by the new flag Player.IsUnknown.
These players are also named "unknown" (and lack a avatar) when replaying these demos in GOTV.Added PlayerFlashed.Projectile, contains a reference to the flashbang's GrenadeProjectile
PlayerFlashed.Projectile, contains a reference to the flashbang's GrenadeProjectile (#158)nil pointer dereference panic that occurred in some demos after the Operation Shattered Web update (#162 / #165)
Some players may now be "unknown" which can be dected by the new flag Player.IsUnknown.
These players are also named "unknown" (and lack a avatar) when replaying these demos in GOTV.Nothing published for this version
Fixed a potential issue with a missing transitive dependency (imghash) - see also https://github.com/jteeuwen/go-bindata/issues/5
imghash) - see also https://github.com/jteeuwen/go-bindata/issues/5Added Player.IsPlanting, true if a player is currently planting the bomb
Player.IsPlanting, true if a player is currently planting the bomb (#132)Player.IsReloading, true if a player is currently reloading (#132)Player.IsAirborne(), returns true if the player is currently in the air (jumping / falling) (#132)worldspawn from EqUnknown to EqWorld (#156)Kill.Killer and WeaponFire.Shooter may be nil in some cases (#156)Implemented fmt.Stringer interface for Player & Equipment
fmt.Stringer interface for Player & Equipmentv1.4.0 - New Features, bug fixes and test Improvements Latest
Latest
Compare
Fixed Player fields in some events sometimes being nil at the start of the demo Affected events:
Player fields in some events sometimes being nil at the start of the demo
Affected events:
KillWeaponFirePlayerFootstepAdded Equipment.AmmoInMaganzine2() & Equipment.AmmoReserve2(), which fix grenade ammo values (#145 - thanks @Linus4)
Equipment.AmmoInMaganzine2() & Equipment.AmmoReserve2(), which fix grenade ammo values (#145 - thanks @Linus4)Player.Weapons()[...].Owner sometimes being nilItemEquip.Player was nil if a player disconnected and was replaced by a bot (#142 - thanks @BestAwperEver)EqDualBerettas.String() (was Barettas instead of Berettas)Added missing Equipment + mapping for the MP5-SD, common.EqMP5 (#138 - thanks @BestAwperEver)
Equipment + mapping for the MP5-SD, common.EqMP5 (#138 - thanks @BestAwperEver)Entity.Destroy() not being called in some cases (#139)Nothing published for this version
ItemPickup.Weapon has been deprecated, use ItemPickup.WeaponTraceable() instead.
ItemPickup.Weapon has been deprecated, use ItemPickup.WeaponTraceable() instead.ItemEquip.Weapon has been deprecated, use ItemEquip.WeaponPtr instead.ItemDrop.Weapon has been deprecated, use ItemDrop.WeaponPtr instead.RankUpdate.SteamID has been deprecated, use RankUpdate.SteamID32 instead.GameState.ConVars() which returns a map[string]string of CVar key-value pairs (#97)events.ConVarsUpdated which signals that CVars have been changed (#97)events.WeaponReload which signals that a player is reloading his weapon (#137)Inferno.Owner() which returns the player that threw the fire grenade (#131)GameState.GamePhase() which returns the current GamePhase (#136)common.EquipmentElementNames() which returns a map[EquipmentElement]string containing weapon names (#135)common.GamePhaseNames() which returns a map[GamePhase]string containing the names of the GamePhases (#135)GenericGameEvent will now always be dispatched, regardless of whether there is a custom, corresponding event in the events package or notItemPickup, ItemEquip & ItemDrop (#119)Equipment.AmmoReserve never being updated (#133)FireGrenadeStart to the end of the tick so EntityID is useful (#131)RankUpdate.SteamID contains the 32-bit SteamID (#128)Thanks to @xXxhaxmeister42xXx for the various contributions to this release.
v1.3.0 – New Features, Better Struct Handling, and Test Improvements
Compare
Nothing published for this version
Player.CashSpentThisRound() has been deprecated, use Player.AdditionalPlayerInformation.CashSpentThisRound instead.
Player.CashSpentThisRound() has been deprecated, use Player.AdditionalPlayerInformation.CashSpentThisRound instead.Player.CashSpentTotal() has been deprecated, use Player.AdditionalPlayerInformation.TotalCashSpent instead.Player.CashSpentThisRound() & Player.CashSpentTotal()Entity.FindProperty() has been deprecated, use Entity.FindPropertyI() instead which returns IProperty instead of *Property
Entity.FindProperty() has been deprecated, use Entity.FindPropertyI() instead which returns IProperty instead of *PropertyEntity.Properties() has been deprecated, use Entity.PropertiesI() instead which returns []IProperty instead of []PropertyTickDone has been deprecated, use FrameDone instead (#120)PlayerSpottersChanged event (#114)common.Player (#114):
IsSpottedBy(*Player) boolHasSpotted(*Player) boolParticipants (#114):
SpottersOf(*Player) []*PlayerSpottedBy(*Player) []*Playercommon.Player for easily retrieving additional data (#115):
Player.IsInBombZone()Player.IsInBuyZone()Player.IsWalking()Player.IsScoped()Player.CashSpentThisRound()Player.CashSpentTotal()common.TeamState for retrieving information over all members of a team:
TeamState.Members()TeamState.CurrentEquipmentValue()TeamState.RoundStartEquipmentValue()TeamState.FreezeTimeEndEquipmentValue()TeamState.CashSpentThisRound()TeamState.CashSpentTotal()events.RankUpdate parsing and dispatching (#112 - thanks @allenymin)EquipmentElement.String() returning M4A1 for EqM4A4 (#124 - thanks @xavier-rodet)Added Vertigo map overview + metadata (#110 - thanks @ArlindoTorres)
DemoHeader.FrameTime() if Header.PlaybackFrames is zero (#108 - thanks @marksamman)Added Player.FlashDurationTimeRemaining() utility function - returns the remaining duration of the flash as of the current tick
Player.FlashDurationTimeRemaining() utility function - returns the remaining duration of the flash as of the current tickParticipants.Connected() function, returns all currently connected players & spectatorsParticipants.All() to return all currently known players of the demo, including disconnected onesParticipants godoc (#100)metadata package (#103 - thanks @o40)Player.IsBlinded() false positives (#96)Participants returning kicked bots (and possibly disconnected players) in some cases (#98)Player=nil for some events after player disconnected (#69)Player.IsBot false negativesParser.ParseNextFrame()Participants.ByEntityID() becoming outdated in some casesAdded Player.TeamState field as shortcut / utility
Player.TeamState field as shortcut / utility (#89)TeamState.Opponent containing the wrong reference and therefore never being updated (#90)EOF panicing, changed to returning ErrUnexpectedEndOfDemo (#93 - thanks @micvbang)Changed return types of Inferno.ConvexHull2D() and Inferno.ConvexHull3D() from *s2.Loop to []r2.Point and quickhull.ConvexHull respectively
Inferno.ConvexHull2D() and Inferno.ConvexHull3D() from *s2.Loop to []r2.Point and quickhull.ConvexHull respectivelyBombDefuseAborted event (dispatched when the property CCSPlayer.m_bIsDefusing of the player from the last bomb_defuse event changes from 1 to 0) (#74)GameState.Team(common.Team) helper to retrieve the TeamState corresponding to a team (#76)TeamState.Team() helper function, returns the common.TeamTerrorists or common.TeamCounterTerrorists (#76)TeamState.Opponent utility link to TeamState of the opponentTeamState fields to events.RoundEnd & events.PlayerTeamChange (#76)Player.IsBlinded() helper functionPlayer.FlashDurationTime() helper function (returns time.Duration instead of float32 like Player.FlashDuration)PlayerFlashed.Attacker field (#70)PlayerFlashed.FlashDuration() helper function (#70)Inferno.ConvexHull3D() not working by using github.com/markus-wa/quickhull-go since github.com/golang/geo/s2 only works in S2 and not in R3BombDropped & BombPickup never containing dataThanks to @quancore & @micvbang for various feature requests and bug reports.
Nothing published for this version
Migrated from [dep](https://github.com/golang/dep) to [Go Modules](https://github.com/golang/go/wiki/Modules) (aka `vgo`) as dependency management sys
vgo) as dependency management system (#61)Parser.GameState() from GameState to IGameState (#66)GameState.Participants() from Participants to IParticipants (#66)TeamState to package common (#55)ParserConfig.AdditionalEventEmitters and package fuzzy since there are now good team/side-switching events (#21).Parser.ParseHeader() no longer needs to be called if the header is not needed.Equipment.ZoomLevel field to indicate how zoomed-in the player is on his weapon (#60)ScoreUpdated event and moved TeamState to package common (#55)TeamSideSwitch, GameHalfEnd, GamePhaseChanged (#62)GameState.IsWarmupPeriod(), GameState.MatchStarted() and events IsWarmupPeriodChanged & MatchStartedChanged (#63 & #64)io.Reader not working as demo sources (when the reader returns less than the requested number of bytes before EOF).Inferno.ConvexHull2D() (#58)Inferno.IsBurning not always being set to true when it should be (#59)Thanks to @micvbang for the various contributions to this release.
See https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Nothing published for this version
Nothing published for this version
Changed type of DemoHeader.PlaybackTime from float32 to time.Duration
DemoHeader.PlaybackTime from float32 to time.DurationDemoHeader.FrameRate() & DemoHeader.TickRate() from float32 to float64Inferno.Active() always returning the full original Inferno.Inferno.UniqueID() function.See https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Nothing published for this version
Cleaned up type names in `events` package (removed stuttery parts etc.)
events package (removed stuttery parts etc.)float32 to time.Duration for DemoHeader.FrameTime(), DemoHeader.TickTime() & Parser.CurrentTime()GameState.Bomb() to retrieve information about the bomb (#41 - thanks @micvbang)Entity.Position() not working for player entities (#38)GameState when destroyed (#39 - thanks @micvbang)See https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Nothing published for this version
Tracking of infernos (Molotovs & Incendiary fires) in GameState.Infernos()
GameState.Infernos()metadata - currently contains translations between the game's world-coordinates and map-overview images. (#37 - thanks @micvbang)GrenadeProjectile.Trajectory - contains the trajectory of a grenade (list of positions)NadeProjectileDestroyedEvent - useful to get the final trajectory of a GrenadeProjectileEntity.OnPositionUpdate() - helper function for position updatesEntity.BindPosition() - helper function for binding the position of an entity to a pointerSee https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Nothing published for this version
Moved player information from GameState.{[Playing]Participants(),TeamMembers()} to GameState.Participants().{All(),Playing(),TeamMembers(),ByUserID(),
GameState.{[Playing]Participants(),TeamMembers()} to GameState.Participants().{All(),Playing(),TeamMembers(),ByUserID(),ByEntityID(),FindByHandle()}Entity.ServerClass() back, in case we don't know what kind of entity we're dealing withSee https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Nothing published for this version
The plan for releasing v1.0.0 is to have beta versions out for a while (1-2 months) without seeing a need for any breaking changes, then we should be…
After a long time the API is finally stable enough so we can comfortably go towards guaranteeing backwards compatibility for the foreseeable future.
The plan for releasing v1.0.0 is to have beta versions out for a while (1-2 months) without seeing a need for any breaking changes, then we should be ready to move forward.
This version aimed to clean up the mess that was sendtables as well as some other issues (see #16). The new API should be more future-proof and expose less of the code that is only used internally.
GameState.{T,CT}State() functions to Team{Terrorists,CounterTerrorists}() so the functions are nicely ordered when sorted alphabeticallyParser.Entities() to GameState.Entities()Parser.SendTableParser() with Parser.ServerClasses() (ServerClasses is fully supported for the future)sendtablesRoundEndReason, RoundMVPReason & HitGroup types & constants to events packageevents.RoundOfficiallyEndedEvent (Officialy -> Officially)events.DataTablesParsedEventevents.ParserWarnEventParser.RegisterNetMessageHandler()See https://github.com/markus-wa/demoinfocs-golang/wiki/v1.0.0-Roadmap
Fixed no events being dispatched in some demos when there should be (#56 - thanks @micvbang)
Added missing weapon mapping for Scout (#53 - thanks @micvbang)
Fixed players not being read from string tables in some cases (#52 - thanks @viSual42)
Fixed Entity.Position() not working for player entities
Entity.Position() not working for player entities (#38)Nothing published for this version
Deprecated PropertyEntry.RegisterPropertyUpdateHandler(), added PropertyEntry.OnUpdate() - they are identical but OnUpdate is shorter & easier to unde…
GameState.GrenadeProjectiles(), contains currently 'live' grenades i.e. flying around and smokes/mollies that are currently up. (#27 thanks @micvbang)NadeProjectileThrownEvent, signals that a nade (projectile) has just been thrownNadeProjectileBouncedEvent, signals that a nade just bounced off a wall or objectNadeEventIf.Base() to get the underlying NadeEventEntity.Position() helper function to get entity positionsEntity.OnCreateFinished() & Entity.OnDestroy() for registering post-creation & pre-deletion actions respectivelyEntity.BindProperty() & PropertyEntry.Bind() utility functions for binding a property's value to a pointerPlayer.Weapons field with Player.Weapons() method (#31)PropertyEntry.RegisterPropertyUpdateHandler(), added PropertyEntry.OnUpdate() - they are identical but OnUpdate is shorter & easier to understand.Player.RawWeapons containing bad data (#31)Added PropertyEntry.Value() to allow access to property values (#26 thanks @zyphie)
PropertyEntry.Value() to allow access to property values (#26 thanks @zyphie)Parser.Entities() to expose Parser.entities (#22 thanks @zyphie)NadeEvent.NadeEntity (#22)sendtables.PropValue might be renamed to PropertyValue or similar in the future.sendtables.FlattenedPropEntry might be renamed to PropertyEntryMetadata or similar in the future.Fixed player reconnects not being handled properly
Fixed weapon data not being updated
Removed `warnHandler` parameter from `NewParser()`, replaced the old warning system with `ParserWarnEvent`
warnHandler parameter from NewParser(), replaced the old warning system with ParserWarnEventNewParserWithBufferSize() with NewParserWithConfig() to allow for changes in the future without breaking the APIevents.GenericGameEvent which is fired for all currently unhandled events.Parser.RegisterNetMessageHandler(). Currently unparsed net-messages can be parsed by adding an entry to ParserConfig.AdditionalNetMessageCreators. <sup>1</sup>ParserConfig.AdditionalEventEmitters which can be used to enable fuzzy logic from the fuzzy package. <sup>1</sup>
Currently there is only one EventEmitter implementation which emits fuzzy.TeamSwitchEvents for Valve MM demos. More will be added if this feature proves to be of use.This release has some breaking changes with the goal of cleaning up the API.
This release has some breaking changes with the goal of cleaning up the API.
Parser.GameState() (i.e. players, team states / scores etc.)Parser.{FrameRate(),FrameTime()} to DemoHeader.* (Accessible via Parser.Header())Parser.SendTableParser() <sup>1</sup>StringTableCreatedEvent <sup>1</sup>UpdateStringTable messages not being handled correctlyunassigned players becoming CTs (Players who haven't chosen a side yet / some spectators)Changed bomb-events attribute Site to be of type bombsite (either events.BombsiteA or events.BombsiteB) instead of rune
Site to be of type bombsite (either events.BombsiteA or events.BombsiteB) instead of runeBombBeginDefuseEvent.Defuser to Player so as to be in line with the other bomb-eventsdebugdemoinfocs for debugging game events etc.depBitReader.Skip())BombBeginDefuseEvent not being handled by BombEventIf handlersWe are using a separate repository for dependencies (https://github.com/markus-wa/demoinfocs-golang-vendor). The reason behind that is to avoid cluttering the repo and avoid search results on github returning irrelevant results.
Added Parser.Header() method to access the DemoHeader (thanks @micvbang)
Parser.Header() method to access the DemoHeader (thanks @micvbang)Parser.ParseHeader() (API breaking)ErrUnexpectedEndOfDemo for unexpected end of streamErrCancelled to identify cancellationFixed #3 (No more panics on incomplete demos)
One column per quarter.