diff options
| author | Mistivia <i@mistivia.com> | 2025-11-02 15:27:18 +0800 |
|---|---|---|
| committer | Mistivia <i@mistivia.com> | 2025-11-02 15:27:18 +0800 |
| commit | e9c24f4af7ed56760f6db7941827d09f6db9020b (patch) | |
| tree | 62128c43b883ce5e3148113350978755779bb5de /teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md | |
| parent | 58d5e7cfda4781d8a57ec52aefd02983835c301a (diff) | |
add matterbridge
Diffstat (limited to 'teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md')
| -rw-r--r-- | teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md b/teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md new file mode 100644 index 0000000..b6e5252 --- /dev/null +++ b/teleirc/matterbridge/vendor/github.com/Philipp15b/go-steam/README.md @@ -0,0 +1,55 @@ +# Steam for Go + +This library implements Steam's protocol to allow automation of different actions on Steam without running an actual Steam client. It is based on [SteamKit2](https://github.com/SteamRE/SteamKit), a .NET library. + +In addition, it contains APIs to Steam Community features, like trade offers and inventories. + +Some of the currently implemented features: + + * Trading and trade offers, including inventories and notifications + * Friend and group management + * Chatting with friends + * Persona states (online, offline, looking to trade, etc.) + * SteamGuard with two-factor authentication + * Team Fortress 2: Crafting, moving, naming and deleting items + +If this is useful to you, there's also the [go-steamapi](https://github.com/Philipp15b/go-steamapi) package that wraps some of the official Steam Web API's types. + +## Installation + + go get github.com/Philipp15b/go-steam + +## Usage + +You can view the documentation with the [`godoc`](http://golang.org/cmd/godoc) tool or +[online on godoc.org](http://godoc.org/github.com/Philipp15b/go-steam). + +You should also take a look at the following sub-packages: + + * [`gsbot`](http://godoc.org/github.com/Philipp15b/go-steam/gsbot) utilites that make writing bots easier + * [example bot](http://godoc.org/github.com/Philipp15b/go-steam/gsbot/gsbot) and [its source code](https://github.com/Philipp15b/go-steam/blob/master/gsbot/gsbot/gsbot.go) + * [`trade`](http://godoc.org/github.com/Philipp15b/go-steam/trade) for trading + * [`tradeoffer`](http://godoc.org/github.com/Philipp15b/go-steam/tradeoffer) for trade offers + * [`economy/inventory`](http://godoc.org/github.com/Philipp15b/go-steam/economy/inventory) for inventories + * [`tf2`](http://godoc.org/github.com/Philipp15b/go-steam/tf2) for Team Fortress 2 related things + +## Working with go-steam + +Whether you want to develop your own Steam bot or directly work on go-steam itself, there are are few things to know. + + * If something is not working, check first if the same operation works (under the same conditions!) in the Steam client on that account. Maybe there's something go-steam doesn't handle correctly or you're missing a warning that's not obviously shown in go-steam. This is particularly important when working with trading since there are [restrictions](https://support.steampowered.com/kb_article.php?ref=1047-edfm-2932), for example newly authorized devices will not be able to trade for seven days. + * Since Steam does not maintain a public API for most of the things go-steam implements, you can expect that sometimes things break randomly. Especially the `trade` and `tradeoffer` packages have been affected in the past. + * Always gather as much information as possible. When you file an issue, be as precise and complete as you can. This makes debugging way easier. + * If you haven't noticed yet, expect to find lots of things out yourself. Debugging can be complicated and Steam's internals are too. + * Sometimes things break and other [SteamKit ports](https://github.com/SteamRE/SteamKit/wiki/Ports) are fixed already. Maybe take a look what people are saying over there? There's also the [SteamKit IRC channel](https://github.com/SteamRE/SteamKit/wiki#contact). + +## Updating go-steam to a new SteamKit version + +Go source code is generated with code in the `generator` directory. +Look at `generator/README.md` for more information on how to use the generator. + +Then, after generating new Go source files, update `go-steam` as necessary. + +## License + +Steam for Go is licensed under the New BSD License. More information can be found in LICENSE.txt. |
